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MIRACLE SYSTEMS ON THE MOVE SMSQ - QDOS COMPATIBLE 


Miracle Systems have now moved from their |SMS2 has been available for some time now but has never been 
York address to Bristol. Their new address | advertised to the QL user for various reasons. Now the original plans 


and telephone number is :- have changed and it has been decided to concentrate on one operating 
system for all systems called SMSQ (SMS - QL compatible). The 
20 Mow Barton operating system will run on all systems with a faster processor and a 
Yate minimum amount of 1MB of RAM, this includes Atari ST/STE/TT, 
Bristol QXL, GoldCard and SuperGoldCard. 
BS17 5NF 
UK SMSO includes a new QDOS compatible operating system which 


provides a much better performance. Included in SMSQ is SBASIC, a 
new compatible SuperBasic language which is able to run as many 
interpreted SBASICs as you want. SBASIC can be started with EX and 
runs at about the same speed as compiled SuperBasic (QLiberated). You 
can also position SBASIC anywhere on screen even on larger than 
normal QL screen sizes. Another facility included is the ability to access 
a DOS or TOS disk exactly like a QDOS disk, the system detects the 
format of the disk automatically. 


(0454) 883602 


DJC - RELEASE P.A.Y.E. MASTER 


DJC has released an archive based program 
for the management of employees P.A.Y.E. 
records. 


It is specifically designed for the UK 
P.A.Y.E. rules and is aimed at employers 
who need to manage all the records 
associated with P.A.Y.E. 


The above system is available now but it is planned to extend the system 
to include a new Screen Driver to allow the updating of overlapping 
windows (at the moment the job is suspended), to allow "background" 
floppy /harddisk operation (no waiting for the format to finish etc.) and a 
pointer-integrated SBASIC environment with Single-step/trace facilities 
The program is available on disk or | and more. 
microdrive and expanded memory is needed 
to run the program. For more information contact Jochen Merz Software (Germany 0203 
501274), Im stillen Winkel 12, 47169 Duisburg, Germany. 

P.A.Y.E. MASTER costs £30 (UK) + £1 for 
overseas postage and is available from 


Dilwyn Jones Computing (0248) 354023, 41 
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<= }~ BASICDeveloomentEnvironment} NEW  +DM50,- | NEW +DM50,- + DM 50,- 
PROGS have reduced the price of both Total price (when ail is available) | with rebote, with- DM 348,= DM 349,= 


PFList and PFData, to make them 
comparable with their other products, to 
BEF 1000. 


QUBBESoft P/D - MINI TOWER SYSTEMS 


If you have already bought the programs at 

the full cost you are entitled to a free update | QUBBESoft P/D is offering to build custom cases for those people who 
if you send PROGS your master disk. This | would like their QL to be in an all in one case similar to the PC. Thus 
includes the new ,faster, PROforma which | avoiding the need for multiple power sockets and avoiding the inevitable 
includes an Epson ESC/P2 printer driver. | forgotten monitor lead syndrome. The cost of this service is entirely 
You are also entitled to a price reduction of | dependent on what the user would like and whether the component parts 
BEF 750 from the PROforma fontpack, this | have to be bought or the user already has the parts. For an estimate of 
price reduction is only valid until the end of | the cost QUBBESoft P/D has produced an enquiry form detailing the 
October. users requirements. 

For more information contact PROGS (016) 

488952, Haachtstraat 92, 3020 Veltem, | If you would like an enquiry form contact QUBBESoft P/D (0376) 
Belgium. 347852, 38 Brunwin Road, Rayne, Braintree, Essex, CM7 5BU. 
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PROGS - RELEASE FONTPACK 


DJC - RELEASE KOINEE GREEK NEW 
TESTAMENT BIBLE FILES 
PROGS have released a product which includes one hundred high quality 
fonts for use with their graphic engine PROforma (Suitable for 

Linedesign, PFdata etc.). 


The Koinee Greek New Testament Bible 
Files consists of a copy of Quill patched to 
allow the greek characters to be used and the 
twenty seven New Testament Nestle Greek 
Scripture books in Quill format. 


The fonts have been licensed from Bitstream” 

and include professional quality fonts with high quality outlines, a 
complete set of characters, full hinting (they are still readable at small 
sizes) and include a complete kerning table. The Koinee Greek version of the Bible is 
considered as the definitive version, which 
has not suffered in the same way from 
translation (or slight mis-translation perhaps) 
to English, etc. 


The fontpack includes a lot of body fonts in several styles (roman, bold, 
italic, bold italic) , display fonts and some dingbat fonts including maths. 


The fontpack includes a manual with a printed copy of all the characters. 
The fontpack costs BEF 4000 and is available from PROGS (016) 
488952, Haachtstraat 92, 3020 Veltem, Belgium. 


The Quill version comes on 4 disks and costs 
£10 (UK). A text87 or plain text version is 
also available on 2 disks costing £5 each 
(UK). Overseas postage is an extra £1 per 
program. For more information contact 
Dilwyn Jones Computing (0248) 354023, 41 
Bro Emrys, Tal-y-Bont, Bangor, Gwynedd, 
LLS7 3YT. 
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JOCHEN MERZ SOFTWARE - 
RELEASE SERIAL/PARALLEL CONVERTER 


tre Letter of ie 
‘Quéas 1 "lovéas ‘ingou Xpierov soubor, shedeas Se *lakwpou, 


‘Guéas 1 rots ty Bey warp. fyompevors nme Taco Apiary 
*Ovdas 2 rerapruerors Aare! 


Jochen Merz Software has released a device that converts standard 25pin 
serial output to Centronics parallel output. The device is configurable 
from 300 to 57600 Baud including 9600 and 19200 Baud. The device also 


includes a 4K buffer and power-supply connector. 
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The device costs DM 159,-(P&P DM 14,- for Europe). For more 
information contact Jochen Merz Software (Germany 0203 501274), Im 
stillen Winkel 12, 47169 Duisburg, Germany. 
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DJC - IMAGE PROCESSOR UPDATED 

PROGS - UPDATE LINEDESIGN & PROFORMA : 

Image Processor, the graphics imaging tool 

PROGS have produced new versions of Linedesign (V2.06) and | from DJC, has been upgrade to allow the 

Proforma (V1.04). saving of screen images in the Pointer 
Environment Bitmap format. The area of the 

The new versions include the reintroduction of the unit, bug in convert to j screen to be saved can be limited to a small 

cures is now fixed, fit to screen is improved, Adobe Illustrator files are | area of the screen up to a maximum area of 

now loaded with the proper colours, and there is improved support for | 512*256 (A normal QL screen size). 

the PROforma fontpack. The new version of Proforma is also faster and 

includes a new Epson ESC/P2 printer driver. An upgrade costs £3 (UK) or £4 (Overseas) 
and can be obtained by sending the master 

An update costs BEF 500 and can be obtained by sending the program | disk back to Dilwyn Jones Computing (0248) 

disk only to PROGS (016) 488952, Haachtstraat 92, 3020 Veltem, | 354023, 41 Bro Emrys, Tal-y-Bont, Bangor, 

Belgium. Gwynedd, LLS57 3YT. 
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QUBBESoft P/D - RELEASE QUBIDE 


QUBIDE is an IDE hard disk interface for 
the QL. It allows you to connect 16 bit IDE 
hard drives (common on the PC) to the QL. 


The interface plugs into the ROM slot of the 
QL and includes the software. The hard disk 
drive can be of any size but only 128mb OL 
drives can be created. This is not a problem 
for drives over 128mb as you can partition 
the drive to behave as though it was two QL 
Drives of 128mb each ie. WIN1_ and 
WIN2.. 


The cost of the Interface is £65 + P&P and 
can be obtained from QUBBESoft P/D 
(0376) 347852, 38 Brunwin Road, Rayne, 
Braintree, Essex, CM7 5BU. 


THE QREVIEW SHOW 


The OReview show will be a combination of Workshop and Traders fair 
to be held on Saturday January 28th 1995 at Rush Green Junior School, 
Romford. The show will be from 10am to Spm. 


Romford lies to the east of London and can easily be reached via the 
M25, A13 and Ai2. Romford can also be reached using public transport, 
it has a British Rail main line station and nearby London Underground 
Stations are only a short bus journey from the venue. More details will 
appear in the next issue. 


The Show will have most UK OL Traders in attendance including 
Miracle Systems, Dilwyn Jones Computing, TF Services, QUBBESoft 
P/D and of course Quo Vadis Design. There may even be an appearance 
by several Traders from the continent. Talks and demonstrations are also 
being planned. 


The finalised details of the show will appear in the next issue of 
QReview due out at the end of the year. If you would like further details 
on the show you can contact Bruce Nicholls at the Quo Vadis Design 
address/telephone number given at the front of the magazine. 


Win up to 7 DitIwyn 
In this Free to enter competTtiton 


Jones Computing programs 


Dilwyn Jones Computing is offering 13 programs, in their ever expanding range of software, as prizes for this easy to 
enter FREE competition (no purchase necessary). The winner of the competition will receive 7 programs of their choice 
from the programs listed below, which could be worth £80. The second place winner will receive 4 programs of their 
choice and the third place winner will receive the remaining 2 programs. 


To enter the competition all you have to do is submit a brief written outline of a new OL program you would like to see 
become available. The submission must be between 100 and 200 words long. 


Please send your submissions to QReview (DJC Competition), Quo Vadis Design, 57 Shaftesbury Road, Romford, 
Essex, RM1 20J. The closing date for submissions is December 10th 1994, with the winners being announced in 


OReview Volume 2 Issue 2. 


Basic Reporter £10 Slowgold £5 Convert-PCX £10 
Rob Roy Pack £10 Image Processor £15 Vision Mixer £10 
Quick Posters £10 DJToolkit £10 Sidewriter £15 
The Cat £5 PD2 Clipart £10 Screen Snatcher £10 
Screen Compression £10 
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In a recent magazine survey 90% of 
readers expressed an interest in 
word processing and 50% described 
it as being their favourite use of the 
QL. About half used Quill as their 
main or only wordprocessor and 
half another wordprocessor, which 
was usually either Perfection or 
Text87. Put in another way, 
although practically every QL user 
has obtained a good user friendly 
wordprocessor free of charge with 
his computer, about a third are 
prepared to spend more than £80 to 
replace this wordprocessor with 
another one. 


Is it worthwhile to do this? I expect 
that most of us are using our 
wordprocessor for such things as 
letters and short reports, and are not 
writing an 80,000 word novel. Quill 
is reputed to be slow and difficult to 
use when a document exceeds about 
3,000 words, but how many of us 
regularly write a document of this 
length? If we buy a _ new 
wordprocessor are we wasting our 
money on extra facilities that we 
shall never or rarely use? Is it, to 
paraphrase one writer, the 
equivalent of buying a furniture van 
to bring your shopping home from 
the supermarket ? 


This series of short articles aims to 
examine this question, to help you 
decide whether or not it is 
worthwhile to move on from Quill 
to another wordprocessor. If you 
have already moved on I hope that 
you will find some tips that will help 
you to get the best from your 
investment. I shall be making the 
comparison of Quill with Perfection 
(Special Edition) for the simple 
reason that Perfection is the 
wordprocessor which I use. I have 
used it from version 2 to the present 
version 5. I have no_ personal 
experience of Text87, but from the 
comments I have read I have no 
doubt that it is a very good program. 
Many of the arguments for a move 
from Quill to Perfection would also 
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apply to a move from Quill to 
Text87. 


One thing that I would like to make 
clear from the start is that I am not 
one of the “speed-freaks". I know 
that Perfection works much more 
quickly and efficiently than Quill, 
but frankly Quill works faster than I 
can type so that it is only when I 
carry out searching and replacing 
operations that the speed is 
important. There are many other 
and better reasons than speed for 
moving on from Quill. 


One of Quill’s weaknesses is cursor 
navigation. It is possible to move the 
cursor by one character, one line, 
one word, or one paragraph per key 
press. There are also commands for 
going to the top or bottom of the 
document or for going to any page. 
Scrolling tends to be slow and, 
although I have never been troubled 
by it, some users report frequent 
crashes when scrolling backwards. 
Another wordprocessor will almost 
certainly offer more cursor 
movements. In addition to those 
available in Quill, Perfection allows 
you to move the cursor to the 
beginning or end of a line, by page 
or by screen depth or width. You 
can also go to the top or bottom of 
the document. to any page or to any 
marked place in the text. These 
extra commands allow you to travel 
through the document more 
efficiently and quickly and reduce 
the need for continual scrolling. If 
you do use scrolling in Perfection it 
works faster and with less problems 
than Quill. 


There is, however, a disadvantage to 
these extra possibilities and that is 
that there are more commands to 
learn. For me this is no problem 
because I use an IBM-style 
keyboard and have the extra keys 
"Home", "End", "PgUp" and "PgDn". 
However, if you still use the original 
QL keyboard you have to 
remember a lot of combinations of 


Oud 


the Alt, Ctr, Shift and the cursor 
keys. 


I think this is what puts many new 
users of Perfection off. You seem to 
be inundated with new commands, 
whereas Quill was so simple. There 
are a number of things that you can 
do to help in this situation. The 
simplest is not to use the new 
commands. I am not being facetious 
in suggesting this. Perfection works 
without the new commands and it is 
not compulsory to use them. There 
is a lot to learn in a new 
wordprocessor, and if you try to 
learn everything at once, you just 
become confused. In the beginning 
just use the cursor movements that 
you use in Quill. When you have got 
used to using Perfection, set aside an 
hour, load a long document (such as 
"help data" on the Perfection disc), 
make a note of all possible cursor 
movements and practice using them. 


Keep a copy..of the list you have 
made of the cursor navigation 
commands and pin it up by your 
work area. Alternatively print out 
the help data file and mark 
important points on it with a felt tip 
pen. Finally make use of the help 
that it available in Perfection by 
pressing F1. Help in Perfection is 
different from help in Quill. In Quill 
the help screens are a sort of 
mini-tutorial that you use when 
learning the program and then do 
not use again. The Perfection help 
screens are curter and crammed full 
of information. They are a reference 
guide to which you may constantly 
have to refer. You can use all the 
search commands that are available 
in Perfection when searching for 
something in the help file. 


The Perfection help file is a normal 
Perfection document, which, if you 
wish, you can modify to suit your 
own needs. If you want to be clever 
you can even write your own help 
file. A Perfection user whose native 
language is not English, could write 
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a help file in his own language. If 
you do write your own help file, 
save it by using the export command 
(F3 1), and don’t forget, maybe 
other QL users can use it too. 


If you buy a new wordprocessor for 
your QL, there is a reasonable 
chance that, initially at least, you are 
going to be disappointed. This is not 
a criticism of the two alternative 
wordprocessors for the QL, 
Perfection and Text87. Both of these 
programs have many happy and 
satisfied users. It is rather a 
comment on the reaction of the 
average computer user when 
confronted with a _ different 
wordprocessor from the one he 
usually uses. A wordprocessor is not 
a toy or a computer game, but a 
serious tool that we use in our 
business and private lives, and 
ideally, just like a new car, we want 
to make serious use of it as soon as 
we have bought it. When you buy a 
new car you want to drive it straight 
away, and not have to stop in the 
middle of the road to consult the 
manual to see what you have to do 
next. However with your new 
wordprocessor you will often have 
to do the equivalent of that. 


Let me give an example of what I 
mean. Footers are very easy to 
design in Quill. You press F3 
followed by F. and at the bottom of 
the screen appear a series of 
instructions. You first have to 
choose where you want the footer 
on the page - None, Right, Left or 
Centre; you then are invited to enter 
the footer text and codes are given 
for the various numbering options - 
Arabic, Roman and Alphabetic; you 
then enter the number of blank lines 
to be placed between the bottom of 
the text and the footer; and finally 
you are given a choice between bold 
or normal text for the footer. It’s as 
simple as that. 


A footer in Perfection starts in the 
same sort of way, although you have 


to press F3 three times followed by 
F (or Alt/Ctr/F) to access the 
command. Do this, however, and all 
you get is a blank screen. Suddenly 
you have a sinking feeling and 
wonder where to begin. 


At first sight it appears that you 
have taken a step backwards in 
moving from Quill to Perfection, but 
it is Perfection that has the better 
footers. The reason that footers in 
Quill are so simple is that they are 
very limited in their possibilities. 
Some users want sophisticated 
footers. A writer of magazine 
articles, for example, may like to 
have a footer containing the page 
number followed by a blank line 
followed by his name and address in 
a different typeface from the main 
text. You cannot do this in Quill. 
You can do it in Perfection. In fact 
you can do practically anything in a 
Perfection footer. Look at how 
Digital Precision show off in the 
footers in the Perfection manual! 


There is a price to pay for these 
extra possibilities and that is that 
Perfection makes more demands on 
the creativity of the user. Hence the 
blank screen when you edit a 
Perfection footer. You have to make 
your own choices of typeface, 
content, style and place of the 
numbering etc, and then look up and 
enter the appropriate control codes. 
It means making extensive use of 
the manual and the help screens. 
For example, you want to know the 
code for arabic numerals? Enter the 
help screen by pressing Fl. Use the 
search facilities (Ctr/F) and look for 
“Arabic”. Not found? Try "number", 


If you move on from Quill to 
another wordprocessor you will be 
constantly confronted with extra 
decision making and extra demands 
on your creativity. How do you 
avoid the wordprocessing equivalent 
of sitting in a new car. desperately 
looking something up in the manual, 
with a whole line of motorists 
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behind you impatiently sounding 
their horns? In your first few 
sessions with the new 
wordprocessor forget all the 
wonderful things it can do; forget all 
the hype in the advertisements; and 
forget all the sales talk. Treat it as 
though it was still Quill and do only 
simple things. 


In Perfection three commands, 
Load, Save and Print, are invoked in 
the same way as Quill by pressing 
F3 followed by the initial letter of 
the command. In the beginning just 
use these three commands. Type 
text without worrying about such 
things as margins, justification or 
underlining. Save it. Reload it. Try 
printing it out. There is a good 
chance that this will work without 
modifying the printer driver. 


Next there are three commands that 
are entered in the same way as 
Quill, except that you have to press 
F3 two times. These are Justify. 
Margins and Tabs. With these 
commands there are some 
differences with Quill. Look these 
up in the manual or the help screen. 
Above all be prepared to 
experiment! Now try entering bold 
or underlined text. This is done 
differently from Quill. Flip through 
the commands at the top of the 
Perfection screen by pressing F3 
continually to discover how to do it. 
Master these commands and you are 


_ already using the wordprocessor. 


Flip through the commands again 
and try those that you have not yet 
tried. You want to learn how to 
write a footer? Enter the footer 
command and then try entering a 
simple footer similar to those in 
Quill. If you are successful, then be 
a littke more ambitious and try 
something you cannot do in Quill. 
An hour set aside for 
experimentation saves a lot of time 
and frustration later on. 


Geoff Wicks 
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ladependent QL Users Group 


Worldwide Membership is by subscription 
only, and offers the following benefits: 
Monthly Newsletter - up to 40 pages 
Massive Software Library - All Free ! 
Free Helpline and Workshops 
Regional Sub-Groups. One near you? 
Advice on Software and Hardware problems 
Subscription just £14 for UK members 
Overseas subscription £17 


Barclaycard: Visa: Access: Mastercard 
* Now in our ELEVENTH successful year * 


Further details from the Membership Secretary 


Bill Newell ———— 
213 Manor Road ES 
Benfleet al 
Essex = 
SS7 4JD ees 


Tel. (0268) 754407 
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FDU is a OQliberator compiled 
SuperBasic program that contains 
the QLIB- runtime routines, 
DJToolkit 1.13 and some extensions 
with names identical to some of the 
Turbo Toolkit. The program was 
written by Davide Santachiara and 
is up to his usual standards. I was 
unable to make the program ’fall 
over’ while testing it on a normal 
QL fitted with a Gold Card but it 
will not work for long on my QXL. 


On the QXL, FDU comes up with 
its initial screen than a Qliberator 
error message informs the world 
that ’at line 30136 - STRINGF 
invalid parameter’ has taken place. 
The options to continue, abort or 
retry can be used. Abort does just 
that, retry just causes the same error 
and continue tries to go on but 
crashes the QXL back to ’Messy 
DOS’ with the error ’the QXL at IO 
address 2BOh is not responding’. 
This is the only program I have used 
that causes this, but I am sure that 
Ergon will have it fixed before long. 


Just in case there was a clash 
between the Turbo Toolkit and the 
extensions used in the program 
which have the same names, and 
probably functions as well, I tried 
again without Turbo Toolkit loaded 
but the same thing happened. 


There is only one version of the 
program on the supplied disc, and it 
contains the Qlib runtime library. 
Anyone who normally loads the 
runtimes in order to save on 
memory when running a number of 
Qliberated programs will have to 
waste around 10 k of memory when 
running FDU. Perhaps _ future 
releases will have a version without 
the runtimes built in as well. 


FDU supplies a number of floppy 
disc utilities, hence the name, in a 
single program. These utilities allow 
floppy discs to be edited, copied, 
formatted and checked. 
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On execution, the program signs on 
with the common Ergon main 
screen and, at the press of any key 
barring ESC, the main menu is 
displayed. As with other Ergon 
programs, FDU uses the "Basic 
Development System’ of menus. 
This gives a familiar feel to the 
program if you have used other 
Ergon products such as DEA, but 
might be a bit confusing at first for 


beginners. 


The Main Menu 

The main menu has nine options. 
Some of these relate to setting up 
the devices to be used and the 
remainder let you select which 
operation you wish to carry out on 
the floppy disc in question. The 
main options are : 


Disc editing 

Copying and verifying discs 
Checking a disc 

Formatting discs 

Setting a discs parameters 


The last option in the above list is 
the most important one and should 
always be chosen when a new disc is 
to be operated on. This lets the 
program know all about the floppy 
to be processed. As a minimum, all 
that need be done is to select 
DOUBLE, HIGH or EXTRA 
HIGH density and let the program 
find out the rest on its own. There is 
no currently known way for the 
density of a 
automatically discovered (unless you 
know different ?) so make sure that 
you get it right before continuing. 
The program at this stage cannot 
handle MSDOS discs automatically. 


Formatting Discs 
This part of FDU allows you to 


format a floppy disc, rename it, 
format it with extra capacity or 
even, format it with less capacity 
than normal. 


I am not at all sure of the safety of 
formatting a floppy with extra 


floppy to be, 


capacity. A readme file on the FDU 


‘disc gives details of drives that 


cannot handle the 5% extra tracks 
that can be attained using FDU so a 
second option allows 2.5% extra 
tracks to be formatted. My drives 
were able to carry out the format 
and the extra space was usable, but, 
I still have my doubts. 


Some drives could be damaged by 
trying to force the heads to a track 
that is not supposed to be there. 
Software distributors would be wise 
not to attempt to squeeze extra files 
into the extra tracks, just in case. 


On the other hand, all drives are 
able to read from a disc that has 
been ’short’ formatted. This option 
is very handy for software 
distributors as it reduces the amount 
of time that they have to wait to 
format a floppy. If you check out 
some of your master discs from 
various suppliers, you will probably 
find that many of them are not 
giving the full 1440 tracks (DS/DD) 
for example. Why format 1440 
tracks when all you need is 200 ? 


None of the above formatting 
options will work unless your disc 
interface supports the FLP_TRACK 
command. 


A disc being formatted takes its 
density and number of tracks 
information from that supplied by 
the user on the ‘Setting a disc 
parameter’ option from the main 
menu. 


Renaming a disc is a simple matter 
of typing in a new name and letting 
FDU get on with it. 


All formatting options can be 
abandoned by pressing ENTER on 
its own when asked for a media 
name. 


Checking Discs 
Checking a disc is a simple matter of 
letting FDU read every sector on 
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the disc. As it checks each track, a 
graphic indicator lets you know how 
well it is getting on. Tracks which 
have one or more bad sectors are 
indicated in red, while good tracks 
are shown in green. 


FDU cannot tell whether the 
information stored in a disc track is 
good, bad or indifferent so don’t 
expect miracles. A file can be 
corrupt simply by having 2 bytes 
interchanged, but the sectors the file 
lives on are readable so FDU 


you put the correct disc in when 
asked for it ! 


As the copy is progressmg, FDU 
shows each track as it is read and 
subsequently written. Once again, 
green shows a good read or write, 


A Wi A? A 


Search from next sector 
Search for > "“_doc" 
Search case independent 


ES 
i 
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before the start of the copy, it tells 
you how many disc swaps will be 
required, This information is also 
displayed when making multiple 
copies. 


Two discs can be compared 


@ 1993 Ergon Development 


written by Davide Santachiara 


ent to re-assemb 
le the source, t 
he easiest vay t 
o patch the task 
12@ INK#O,2:PRIN 


g Search from start 
4 


T#B, ‘Loading Flo 
ppy Disk Utiliti 
es... rINK#G,4. 
130 EXEC 'flpi_D 
ISKUTIL_OBJ' . ta- 
space so you mus 


4 Search file/block no. (map) 

5 Search possible file start 

erststs i 20 4 S45 4 G 
@@98 49 53 4B 55 54 49 4C SF 4F 42 4A 
@GAG 73 70 61 63 65 20 73 GF 20 79 6F 


considers the disc to be ok. 


Copying and verifying 


Once you have chosen the source 
and target drives on the main menu, 
you are all set to make single or 
multiple copies of the source disc. 
FDU copies whole discs at a time 
and does not copy single files. If you 
need to copy files, use WCOPY or 
something similar. FDU is for 
copying whole discs. 


If a disc is found to have bad 
sectors, these are written to the 
output disc depending upon what 
information was read off of the 
source disc. This is good and it 
means that you can use the copy to 
play with the disc editor rather than 
trashing the only copy you have of 
the information. 


Verifying can be turned off or on 
according to your needs, as can 
pre-formatting the target disc before 
the copy takes place. Both of these 
options increase the time to make a 


copy. 


Internally, FDU optimises the order 
that sectors are read from the disc, 
depending upon whether it is 
running on a Gold Card or not. This 
helps to speed up the copying. 
Before the copy gets under way, 
FDU tells you how much of the disc 
can be held in memory and how 
many passes are required to make 
the required number of copies. 
Watch the prompts and make sure 


rack: 12 Side: 1 Sector: 8 Part 1/2. Logic: 225 


File: $083 Block: $080a_Name:_?? 


red a bad one and white shows a 
good verify, if this option is switched 
on. 


The target disc(s) should all be the 
same density as the source disc. In 
this option, the program doesn’t 
seem to mind getting a MSDOS disc 
in the target drive as it is writing to 
it. As long as the target is formatted 
(or will be formatted by the copy) it 
will work ok. Bad sectors are noted 
on the screen as they are detected. 


Copying a double density (720K or 
1440 sectors) floppy took 148 
seconds with everything turned off. 
Verifying the disc after writing it 
took an extra 66 seconds when that 
option was turned on. FDU copies 
the entire disc or as much as it has 
in memory, then verifies it. The 
program detected that a sector was 
bad on the source disc which 
probably increased the time taken to 
make the copy. 


If you only have a single disc, FDU 
can held make backups as it will ask 
for the source and target discs to be 
swapped as and when required. Just 
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t reset it to 66 
8B bytes after ed 
iting with LBYTE 
S$ and SEXEC, OAT 
ASPACE_TASK from 


Lg enn gcc 


together, verified, without copying 
one to the other first - obviously, 
this will not be of much use unless 
the 2 discs are copies of each other. 
Of course, you could use this to 
check that one disc is a clone of the 
other and not just a WCOPY or 
something else along those lines. 


Disc Editing 

This is the most complex and 
potentially the most dangerous part 
of FDU. Disc sector editing can be 
used to rescue lost data or to 
completely trash it beyond all hope 
of recovery - you have been warned 
' 


Because of the nature of this facility, 
a fairly large section of the manual 
is devoted to a tutorial of its use. 
This tutorial is easy to follow, 
however, before trying out any of 
the editing functions, MAKE A 
BACKUP OF THE DISC YOU 
ARE WORKING ON AND USE 
THAT. It might also be a good idea 
to read the section in the manual 
that explains exactly how tracks, 
sectors, blocks and files are arranged 
on a floppy disc. A_ better 
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understanding of the background 
processes can help sometimes. 


The disc editor allows you to 
directly edit sectors, search for some 
text on the disc, collect files from 
the corrupted disc and, if your 
directory has been lost, search the 
disc for all possible file starting 
sectors. 


This last option is handy. If your 
directory sectors are bad, then how 
do you know where a file begins on 
the disc ? The ’easy’ answer is that 
when the file was first created, a 
copy of the 64 byte directory entry 
for that file was written to the first 
64 bytes of the first sector used to 
store the file. This header was not 
an exact copy as it contains only the 
file name and its size, the size 
always being set to 64 bytes. 


Why this disc layout is used, I have 
never seen written down, but as it is 
there, FDU makes good use of it to 
find potential files for recovery. 
Once written, this dummy header is 
never re-written or updated for that 
file. 


Once a file start sector is found, its 
details are written to the screen 
ready for you to start collecting, or 
you can ignore it and try to find 
another file. 


Collecting files is the relatively 
simple process of opening a file to 
hold the recovered data, the 
collector file, collecting all possible 
sectors of the original file from the 
bad disc and closing the collector 
file. A small amount of editing may 
them be required to remove extra 
rubbish from the final sector. The 
collection process writes complete 
sectors to the collector file, but if the 
original file did not fully fill up the 
last one, certain amounts of rubbish 
will be held in it and requires 
editing. 


This is fairly easy to do for a file 
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that is pure text, such as a 
SuperBasic listing, but for other file 
types, it could be a problem. Quill 
files, for example, have their own 
*rubbish’ areas at the bottom of the 
file so it can be difficult to figure out 
where this good rubbish starts and 
where the nasty stuff starts. (One 
little utility that might help, but only 
with recovered Quill files, is Dilwyn 
Jones’ STRIPPER program that 
converts a Quill file into plain text. 
This is available from the Quanta 
library on disc PSOS. It doesn’t care 
about the good or bad rubbish, 
provided that the first sector of the 
file is ok.) 


Machine code files will be a 
problem, especially if you don’t 
know about their length, dataspace, 
file type etc. FDU doesn’t help 
much here, unless you load the 
directory into FDU - this does show 
the required information, but if the 
disc directory is trashed, much of it 
will be corrupted anyway. (I bet you 
wish that you had made a backup 
now don’t you ?) 


Files can be collect automatically. 
Select the file from the list in the 
directory and the program will show 
a menu of all the block numbers for 
that file. You can deselect one or all 
of them so that it/they are not 
included in the collection then press 
ENTER. The ’where am I on the 
disc’ indicator will then go 
absolutely mental as FDU zooms 


around the disc extracting sectors (in 


order) and writing them to the 
collector file. 


Once this is done, and it might not 
take very long, the file is collected. 
Close the collector file and you are 
ready to collect the next file. 


Collection can be done manually, by 
sector or by block (groups of 3 
sectors) should you not be able to 
collect automatically. 


It has to be said that manual disc 


BI 


recovery is a long and very boring 
job. I have had to do it in the past, 
once for my own discs and a couple 
of times for a Quanta member (who 
shall remain nameless !) who had a 
couple of Archive discs trashed and 
no backups. You might think that 
backing up your work is quite 
boring, but just wait until you are in 
the position of having to attempt a 
recovery. Keep taking those 
backups. 


Summa 

Davide has done a good job of 
automating the disc recovery 
process and I find it hard to see how 
it could be made any easier. The 
formatting utilities work well, but I 
am a bit suspicious of the extra 
capacity functions. With floppy discs 
costing around 25p each these days, 
is it worth trying to get 5% extra 
storage and run the risk of damaging 
your drives ? That said, they do 
work. 


Disc copying is quite fast and the 
verifying option is quite nice as it 
gives extra piece of mind that the 
copy did actually work. 


All in all, a good and useful 
program. You can obtam FDU 
direct from Ergon Developments in 
Italy, or if you wish, from Dilwyn 
Jones Computing in deepest, darkest 
Wales. Anything that uses DJToolkit 
can’t be all bad, can it ? 


Norman Dunbar 


Floppy Disk Utilities costs £18 
and requires expanded memory. 
It can be obtained from either 
Ergon (Italy 39 522 70409), c/o 
Davide Santachiara, Via Emilio 
De Marchi 2, 42100 Reggio 
Emilia, Italy or Dilwyn Jones 
Computing (0248) 354023, 41 
Bro Emrys, Tal-y-Bont, Bangor, 
Gwynedd, LL57 3YT. 
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SUNDAY 16TH OCTOBER 1994 10AM TO 4.30PM 


The Queen Hotel, City Road, Chester (opposite railway station, 
at junction of City Road and Brooke Street, follow signs for station) 


M53 ma io Admission free! 


AGG CiedleRE M56 - Car parking {Tih joken 
(traffic mas M6 - QL traders present 

4 12(of M53) ‘ 
CHESTER é of Mio Talks and lectures 


inner ' AD51 - Easy to find venue 


ring road (Midlands) ' , 
- near railway station 


= Railway Station ' Bring & Buy stand 
A55 and The Queen Hotel] + Meet other QL users 
ayatee) (map not to scale) - Organised by DJC 
ACCOMMODATION - Several hotels / guest houses near to the venue. 
FURTHER DETAILS (e.g. hotels list): Dilwyn Jones (0248) 354023 


Miracle Systems Ltd (0904) 423986, Mike Kenneally: (0625) 878207 
(Thanks to Mike Kennealiy (Club QL International) for general help!) 


DJC LOOKS FORWARD TO MEETING OUR CUSTOMERS AT 
THE CHESTER QL SHOW ON 16/10/94! 


WATCH OUT FOR SPECIAL OFFERS & BARGAINS AT THIS SHOW ! 


We will also be at Clevedon Quanta Workshop 20/11/94 
| and at the QReview show, Romford, 28/1/95 | 
THE POINTER ENVIRONMENT & QPAC2 


POINTER ENVIRONMENT "“IDIOT’S GUIDE” You may have heard a lot 
recently about the Pointer Environment and QPAC2, but may have been 
frightened off by reports that it is difficult to learn and to set up. True, there is 
a lot to learn, and this can make it seem difficult at first. But DUC has listened 
to QPAC2 users and done something about it! A new 20 page booklet by 
Norman Dunbar sets out to provide a simpler introduction to this most 
essential of QL software. Pointer Environment will become an essential part 
of every QL user’s software setup sooner or later, especially when enhanced 
QL graphics hardware becomes available! Oh, the title - don’t be offended, ail 
is explained in this booklet! Available FREE on request with orders for 
QPAC2, or £2.00 to cover costs if you already have QPAC2. 

QPACCER - SpakWae) program to help you to set up boot programs for use 
with QPAC2. Expanded memory required. QPACCER is available from QL 
PD libraries, or from DJC for £2.00 


QPACZ .... £39.95 QPAC1 ... £19.95 


QPAC1 is an accessory pack of several small pointer driven 
programs which can be used with or without QPAC2 


LINE DESIGN @eoe* 
It was used to produce and print 


this ad - say no more! £100.00 
(printed from a QL using a HP Deskjet 500) 


PROFORMA FONTPACK 
ALSO AVAILABLE - new pack of 


100 high quality fonts for use with 
LineDesign and Proforma £80.00 


PROFORMA 


*C’ programmers can now access 
the drivers, graphics etc of 
Line Design! £100.00 


DATA DESIGN database £60.00 
DATA DESIGN API £20.00 
PFData £20.00  PFiist £20.00 
ptb2pff (font converter) £60.00 


BASIC Reporter 

Bible text disks 
Cocktaits Waiter 
Convert-PCX 

Cricket Secretary 
Cue-Sheill 

Data Design 3 

Data Design API 
DBEasy 

DBProgs 

DEA disassembler 
Deskjet-A5 

Disa 2 

Discover 

DJToolkit 

Easyptr 3 part 1 

Easyptr 3 part 2 
Easyptr 3 part 3 
Filemaster 

Files 2 

Five Game Pack 
Flashback 

Flashback Special Edition 
Fleet Tactical Command 
Flightdeck 

Floppy Disk Utilities 
4Matter & Locksmithe 
Fountext94+Founted89 
(Text87 driver) 

FTC Data Printer 
Fugitive 

Genealogist 3 
Genealogist 2nd Edition 
Genealogist 2 to 3 upgrade 
Genealogist 128k 
(budget version) 

Grey Wolf 

Home Budget 

Image-D 


Image Processor SAFE E220 


Line Design 2 
Locksmithe 

Masterbasic 

MDV Toolchest 
MegaToolkit (disk) 
Megat oolkit (eprom) 
Micro Process Controller 
MPC software 


(Toolkit for use with Process Controtier) 


Multi Discover 


45.00 
10.00 
20.00 
10.00 
20.00 
10.00 
10.00 
12.00 
40.00 
60.00 
20.00 
15.00 
15.00 
26.00 
12.00 
40.00 
20.00 
10.00 
40.50 
20.08 
20.00 
12.00 
12.00 
12.50 
25.00 
40.00 
39.95 
45.00 
18.00 
23.50 
39.00 


9.95 
9.95 
60.00 
30.00 
33.00 
12.00 


12.50 

20.00 
_ 10.00 
1 


9.95 


30.00 


Music Manager 
Network Prover 
OPD Interchange 
Open Golf 

Open World 

Page Designer 3 
Painter 

P.A.Y.E. Master (UK only) 
PD2 Clipart 
Picturemaster 
Picturemaster Plus 
Printermaster 
Publishers Pack 
Qindex 

QL-PC Fileserver 
QLiberator 3.36 
QLiberator, budget version 
QLibrary Manager 
QLOAD and QREF 
QPAC1 

QPAC2 

QPower regulator 
QRactal 


QTOP 

QTYP2 

Question Master 
Quick Mandelbrot 


Quick Posters 

Quiz Master 

Ramdisk 

Return To Eden 

Rob Roy Pack 

R.P.M. 

Scanned Clipart 1 

Scanned Clipart 2 

Screen Compression 

Screen Dazzler 

Screen Economiser 

Screen Snatcher 

S_Edit editor 

SerMouse (+2.50 postage) 

Sidewinder Plus 

(screen dumps) 

Sidewriter 2USSaWReLEDO: 

(sideways text printing) 

Slowgold 

Solitaire 
Save 1/3 f 

Spectrum Emulator Zm/128 

Spectrum Emulator Zm/HT 

Speedscreen (disk/mdv) 

Speedscreen 

(Eprom+disk/mdv copy) 


Spellbound 30.00 
Spellbound Special Edition 50.00 
Squidgy Round The World 12.50 
SToQL 12.50 
Super Disk Index 42.00 
Super Disk Labeller 10.00 
Taskmaster 25.00 
Taskmaster hard disk upgrade 5.00 
Text87 Plus 4 79.00 
2488 Text87 drivers 23.00 
Textidy 15.00 
Text 'N’ Graphix 15.00 
The Clipart 12.00 
The Gopher 12.00 
3D Terrain 12.50 
Toolkit 2 (disk/mdv) 19.95 
Toolkit 2 (EPROM) 24.95 
Trans24 10.00 
Typeset94 (Text87 drivers) 29.00 
Video Titles 5.00 
Vision Mixer 1 10.00 
Vision Mixer Plus 22.50 
Winback 25.00 


[ SPECIAL OFFERS VALID TO 31/12/94 | 


FLOPPY DISKS DSDD 3.5" 0.40 
FLOPPY DISKS DSHD 3.5" 0.70 
ED DISKS - Call to ask for prices! 
DISK LABELS 3.5" roll 100 2.00 
DISK LABELS 100 on tractor feed 2.50 
ADDRESS LABELS roil 100 2.00 
MICRODRIVE CARTRIDGES 2.50 
Add 2.50 postage for floppy disks, or 
0.50 posiage if only ordering labels. 


QReview magazine UK per issue 2.00 
QReview (Europe) 2.50 
QReview (other countries) 3:75 
1QLR from Vol 4 issue 2 (each) 4.25 


Cail or write for a FREE copy of our 
full 28 page QL catalogue. 


DISCOUNTS (SOFTWARE ONLY) 5% FOR 2 PROGRAMS, 10% FOR 3 OR MORE,INCLUDING OFFERS! 


TERMS AND CONDITIONS. All prices shown in UK Pounds Sterling. Software sent post free to U.K, 
overseas add 1.00 per program (maximum 3.00). Buiky items - see above for postage. PAYMENT - Make cheques 
or Eurocheques (in Pounds Sterling, drawn on UK branch of bank or building society) payable to “Dilwyn Jones 


Computing”. Payment by credit card (Visa/Access/Mastercard/Eurocard) also accepted. Minimum order is now §.00 
due to bank charges. Goods, whether individually identifiable or not, remain the property of Difwyn Jones 
Computing until payment in full for them has been received by DJC. Under credit card company rules, we can only 
send goods paid for by credit card to the cardholder's registered address. 


SVENSKA QL-GRUPPEN 


I’m writing this to tell you a little about the 
Swedish QL Group and QL in Sweden. When the 
QL was launched, 10 years ago, it was met with 
interest in Sweden. They say that we are 
particularly found of establishing associations 
here in Sweden, I don’t know if that’s true, but 
soon there was founded a club around the QL. It 
is (and was) called "Svenska QL-gruppen" (The 
Swedish QL Group) and was founded in 1985. 
The first member list (from October 1985) shows 
a count of 33 members, most of them living in 
the neighbourhood of Gothenburg. 


The main reason why the group was founded in 
Gothenburg was probably that the QL was used 
for education at the Chalmers University of 
Technology, in Gothenburg. 


One year later we were about 160 members. 


I think that I joined the group in the spring 1987, 
I would have joined earlier if I had known about 
the group. Since then I’ve been an active 
member of the Swedish QL Group. Now I am 
(unfortunately?) also secretary of the group. 


When the QL was new, the only way to acquire a 
QL in Sweden was to go to England and buy a 
QL there. There was, however, soon lots of small 
enterprises importing the QL (English version) 
and you could buy your QL from about 10 
different sources. The General Agent did not sell 
any QL’s for a long time, they wanted to make a 
Swedish version, with our special letters A.A & 
O on the keyboard, first. When they finally were 
ready valuable time had been lost (some people 
even bought "[BM’s") and they found that the QL 
was not such a success in Sweden as for example 
the Spectrum had been. Besides I think they 
priced the QL too high, a QL bought from them 
was about twice the price compared to a QL 
bought in England. 


The QL did soon find a place in education, as I 
said before, at Chalmers University of 
Technology, and the Swedish QL Group still has 
strong connections to Chalmers. The Ericson 
telecom company bought a large amount of QL’s 
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(according to some rumours 1000 QL’s) for their 
employees, and a club called "EDKX" was 
started. We tried to establish a cooperation with 
EDKX but [m sad to say that we did not 
succeed. I don’t know if EDKX are still active 
today. (By the way, I bought my first QL second 
hand from an Ericson man who was moving to 
the USA.) | 


At my office I convinced the manager that the 
QL was the cheapest way of learning to use 
computers, and we were able to put a QL on 
everyones table. Some of my former colleagues 
did not appreciate it, but most did. The main use 
of the QL was as a wordprocessor using Quill. I 
soon found it necessary to write a compendium 
on Quill, in Swedish, because many of my former 
colleagues had difficulties in understanding 
English, and the "User Guide" was not very easy 
to follow. I have been told that it is a very good 
compendium, but I don’t think it will ever appear 
in an English version. The introduction of the QL 
in my former office was rather successful, but 
according to orders from a higher authority they 
have now been abandoned in favour of 
MS-DOS-computers. 


I then spent most of my spare time for a year on 
writing a second compendium, this time on 
Abacus, but it still misses that "finishing touch". 


For the last three years I have spent most of my 
"QL time" on preparing a big database on 
photographical chemicals, as photography is 
another big interest of mine. (I’m a chemist by 
profession.) I have also spent a lot of time on the 
construction of a new box for the QL, and maybe 
I will write a separate article on that some time 
in the future. It’s my intention to make that into a 
"club project" in the Swedish QL Group. 


I know of only two places where the QL is put to 
"professional work" nowadays. One is by a 
member of the Swedish QL Group, Inge 
Palmqvist, who has written a very big program in 
SuperBASIC for his profession (he is a bridge 
builder), and the other is by an authority in 
Norway, where Arvid Borretzen has a network 
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(of QL-emulating Atari’s). All other QL users I 
know are using QL as a hobby, or in education, 
and I’m sad to say that these days far to many are 
abandoning the QL in favour of IBM or 
Macintosh. 


Since Sweden is a rather big country (by area) 
many of our members cannot visit our monthly 
meetings held in Gothenburg or Linkdping 
(where we have an active sub-group), and thus 
we think that our magazine "Svenska QL-bladet" 
is Our most important way of supporting our 
members. We do also have a program library for 
our members and do exchange programs with 
other QL clubs. We are also planning some 
easier hardware "projects", for those who like 
soldering. Once a year we arrange a bigger 
meeting, usually in Linképing and we also try to 
go abroad once a year to visit some meeting in 
Europe. 


This autumn we will try to arrange a 
"Scandinavian meeting" which will be held in 
Gothenburg the 1st and 2nd of October. As I’m 
writing this I don’t know how we will succeed, 
but I’ve already heard from our Norwegian 
friends (NASA) that they will try to come. We 
don’t know about any QL clubs in Denmark or 
Finland, but we could always hope that the 
rumour of the meeting will reach Denmark and 
Finland too. {The meeting is going ahead | 


We do, of course, expect most visitors to come 
from Scandinavia. but anyone with an interest in 
the QL and related things is very welcome. Most 
people in Sweden understand English. (Besides I 
think Gothenburg is very nice, but I’m born here 
so maybe I’m biased.) 


The Swedish QL Group intend to show : 


Two different I/O-cards for experimentation, 
one simple and one advanced. 


Two different enclosures for the QL, one built of 
standard components, and one built from sheet 
metal. 
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How the QL is used in the education at Chalmers 
University of technology in Gothenburg. 

Some examination tasks from Chalmers 
University of Technology. 


A big technical program, written in SuperBASIC 
by one of our members. 


A rather big database on photographical 
chemicals (in Archive) . 


Chalmers Mathematical and Graphical Toolkit 
(maybe already well known). 


A home-made digitizer and a plotter made by 
one of our most prolific mechanical "hackers". 


And maybe something more... 


but as we are expecting some foreign guests we 
intend to give them the highest priority, and thus 
some of our own things may be cancelled. 


We have lost quite a number of our members 
during the last two years. and we don’t know 
exactly why. We have also acquired a few new 
members. Our members are inherently lazy, and 
don’t tell us what they want from the Group, and 
thus we can only guess what they want us to do. 
Many of our lost members have probably handed 
over their QL to a son or a daughter and we 
believe there is a need of support to the very 
beginner. In the future we will try to provide that 
and we are now Starting a special column for 
beginners in our magazine "Svenska QL-bladet", 
and thus I think, it is very important that anyone 
giving away their OL to a relative also informs 
the the Swedish OL Group. 


This applies. of course, to other countries also, 
but then the important information is for 
example in QUANTA, QReview. Since the OL 
nowadays is becoming a rare computer we have 
to stick together to be able to support each other. 


Sone Thoren 
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The QXL from Miracle Systems has 
taken a lot of time and resources to 
be developed, rumoured to be over 
£50,000, and now is only beginning 
to reach its potential. 


The problem with its early 
development lie not with the 
hardware but with the software. The 
first releases of the software SMSQ, 
more of which later, did not provide 
the full resources which a normal 
QL compatible could offer. The 
main stumbling blocks were the lack 
of a SuperBasic and compatibility 
with the older QL software. Now 
the software has been brought up to 
date with a new and powerful 
SuperBasic compatible language 
known as SBASIC and compatiblity 
with older OL software has been 
made acceptable. Has the QXL 
come of age ? 


WHAT IS THE OXL? 


The QXL is a small PC (Personal 
Computer) circuit board, called a 
half card (because of its small size) 
which plugs into a slot specifically 
designed to accept these type of 
cards on a PC. The slot is called an 
ISA slot which stands for Industry 
Standard Architecture. The card 
contains a 68040 processor 
(68EC040 to be precise) which runs 
at a speed of 20MHz (Mega-Hertz). 
This is a very powerful processor 
which provides the QXL with a very 
good speed rating of about 4 times 
the speed of a Gold Card. The 
RAM of the QXL is also contained 
on the board which can either be 
4M or 8M as detailed in Miracle 
Systems latest advert. It is important 
that the RAM is on board the OXL 
as you can switch between the 
native PC mode and the QL mode 
without interrupting the QXL. This 
means you can be running both PC 
and QOL applications at once. The 
QXL only uses the PC for its 1/O 
system giving QL programs access 
to the PC’s floppy disk, hard disk, 
keyboard, display, serial and parallel 
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ports. For further compatibility the 
QXL has QL style network ports. 


To be able to run the QXL on a PC 
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into this slot (See the photograph on 
this page). The QXL comes pre- 
configured for a certain address 
which should work in most machines 


the PC must have a spare 8-bit or 
16-bit ISA slot (See below) and 
have a minimum graphics 
resolution of EGA (Enhanced 
Graphics Adaptor) so that it can 
display the normal QL Display on 
screen. 


INSTALLATION 


The picture on the front cover 
shows what you get when you buy a 
QXL. There is the QXL card itself 
together with the SMSO software on 
disk and a small instruction sheet. 
The instructions are very simple and 
detail how to printout the rest of the 
instructions contained on the DOS 
disk supplied. These need to be 
printed off before the QXL is 
installed. Because of the frequent 
changes in the software a manual 
has never been produced but this is 
being rectified now. I have seen the 
pre-release version of the manual 
and it details all the new features of 
the QXL card and SMSQ with 
examples. 


The imstallation of the QXL 
hardware is simply a matter of 
opening up the PC and locating an 
empty ISA slot and pushing the card 
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without further alteration. If this 
does need to be changed full 
instructions are given in the 
instruction sheets. These are very 
well written for the PC layman, they 
even detail the difference between 
an 8-bit and a 16-bit slot (A 16-bit 
slot consists of two connectors in 
line, one slightly longer than the 
other; an 8-bit slot consists of just 
one connector). 


Once the hardware has been 
installed the PC can be turned on 
and the software to make the OXL 
run can be installed. This can be 
installed on the hard disk of the PC 
or it can be run from the floppy 
drive. To start the QXL you type in 
QXL which runs a PC EXE file to 
load and swap to the QXL card. 


If there is no address clash with any 
other PCcards you will be 
presented with the familiar three 
QDOS Monitor SuperBasic 
windows (Mine worked first time). 
If there is a clash you can change 
the board address with the 
instructions given in the instructions. 
However this is not OQDOS this is 
SMSO. 
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To switch back to the PC you can 
press the key combination CTRL + 
SCROLL LOCK. This still leaves 
the OXL working and you can then 
swap back to SMSQ by typing in 
QXL/ which will restart the QXL 
from where you left off. 


SMSQ 


SMSQ is based on the SMS Kernel 
which has been modified to provide 
a degree of QDOS compatibility. 
The Kernel is larger in size than 
QDOS but it is still more efficient 
than the old QDOS Kernel. 


SuperBasic has been replaced by 
SBASIC which runs much faster, in 
fact at speeds approaching that of 
compiled programs. SBASIC can 
now be EXECuted directly and 
multiple copies can exist. 


SMSQ contains all the QL 
SuperBasic commands plus the TK2 
commands although some 
commands have been extended to 
provide new enhanced features. 


One nice feature is the ability of 
SMSO to recognise “foreign” disks. 
This means you can directly read 


Using Quill you can read these files 
without the need to first transfer the 
files on to a QDOS disk. 
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SMSO is also able to utilise the 
extended screen resolutions the PC 
is capable of. Four preconfigured 
versions of SMSQ are given to run 
in 4 different screen resolutions. 
These are:- 


SMSQQL = - 512256 in mode 4 
SHSQEGA - 640%350 in mode 4 
SHSQVGA - 640*480 in mode 4 


SMSQSVGA - 800*600 in mode 4 
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other formats of disk other than 
QDOS. A good example is the DOS 
disk that contains SMSQ, on this 
disk are several Quill DOC (files. 
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Only Pointer Environment programs 
written for larger screens are able to 
utilise the extra screen size fully. 


Two examples are shown on this 
page. The first is linedesign being 
run in SMSQVGA mode, this shows 
how impressive a large screen 


resolution can be. The second screen 
shot shows the same resolution. This 
has easel showing the normal QL 
screen size with several OPAC2 
programs running in the extra screen 
areas. 


I will be talking more about SMSQ, 
SBASIC and compatibility in the 
next issue of the magazine. 


HARDWARE UTILISATION 


The QXL has access to the hard 
disk of the PC by the command 
FORMAT "WIN1 20". This would 
create a file on the PC hard disk of 
20 Megabytes. WIN1_ will then be 
just like any other device except 
larger. 


At present you can only create one 
hard disk partition up to a maximum 
size of 63MB. I would like to see 
this feature extended to allow 
additional hard drives to be created 
to be named WIN2_ etc. 


More next issue ..... 


Bruce Nicholls 
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PD & Shareware Software 


QL Emulator AMIGA V3.21 (3 Disks) 
C68 Compiler Runtimes (3 Disks) 

C68 Compiler Source Code (2 Disks) 
MicroEMACS V3.11 (2 Disks) 

GNU Text Utilities (2 Disks) 
Adventure '93 (2 Disks) 

XLisp V2.1d (2 Disks) 

STAR TREK Reference (2 Disks) 


SPECIAL 1 Q.A.T.S. 

SPECIAL 2 Molecular Graphics V5.11 
SPECIAL 3 XLisp V1.4a 

SPECIAL 4 QPACER 

SPECIAL 5 'C' Tutorial 

SPECIAL 6 C68 QPTR Comp V3.02 
SPECIAL 7 CPORT Support Library 
SPECIAL 8 QRactal Screens Demo 
SPECIAL 9 QL Home Finance 
SPECIAL 10 ZM1+ Spectrum Emulator 
SPECIAL 11 Lib CURSES V1.20 
SPECIAL 12 ELVIS Editor V1.6 
SPECIAL 13 Text 'N' Graphics Demo 
SPECIAL 14 'C' Programming Tools 1 
SPECIAL 15 'C' Debugging Tools 
SPECIAL 16 Ergon Dev Demo Disk 
SPECIAL 17 Ger to Engl Word List 
SPECIAL 18 QDesign Demo 
SPECIAL 19 D.J.Walker Demo Disk 
SPECIAL 20 DBAS Database Package 
SPECIAL 21 FTC I Demo 

SPECIAL 22 QL Hard Disk 

SPECIAL 23 PSION Xchange 
SPECIAL 24 SPECULATOR '93 
SPECIAL 25 QLIPER Disk 

SPECIAL 26 Line Design 2 Demo 
SPECIAL 27 Compu-Clips 1 
SPECIAL 28 Bison V1.21 

SPECIAL 29 Flex V2.3 


P.D. Disks No's 1 to 14 
QITALY Disk Mag Issue 15 to 25 


to P&P Guide. Medium is 3.5in DS/DD. 


£3.00p 
£3.00p 
£2.00p 
£2.00p 
£2.00p 
£2.00p 
£2.00p 
£2.00p 


£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 
£1.00p 


£1.00p each 
£1.00p each 
All prices Include Medium but not P&P. Please refer 


New QL Hardware 


Fast-Net: Local Area Network, enabling connectic 

between QL & QL, QL & ST, ST & ST (ST musi 
be running QDOS), Fully compatable with existing 
hardware expansion systems (Gold Card, Trump 
Card, Super Q Board etc etc). Runs approximately 9 
times faster than existing QL Network. Plugs into QL 
or ST ROM slot via ribbon cable and tongue. Can 
utilise existing QL Network Cable. Software includes 
File Server. Full Documentation included. Minimum 


Configuration 2 Units 
Each Additional Fast-Net Unit: 


Trump Card: 768K RAM, Toolkit 


£120.00p 
£ 65.00p 
2, Disk 


Interface, Dynamic RAM Disk, Printer Buffer. 


Includes A4 Manual 


£95.00p 


ExpandeRAM 512: 512K RAM with through po 
to connect other peripherals i.e. Disk Interfac., 


Eprom Board 


£45.00p 


ExpandeRAM 0: OK RAM, as above except User 


supplies RAM chips 


£20.00p 


Twin 720K Disk Drives: Fully Cased with internal 


Power Supply Unit 


£100.00p 


Twin 1.44mb Disk Drives: Fully Cased with internal 


Power Supply Unit 


£150.00p 


Twin 3.2mb Disk Drives: Fully Cased with internal 


Power Supply Unit 


1 Year Warranty on all New Hardware 


(P&P; UK + 5%- Max £5.00p, Euro +°10%- Max £10.00p, RO.W. + 20%- Max £20.00p) 


New Hardware in Pipeline 


£200.00p 


QUBIDE: IDE Hard Disk I/Face, allows connection 
of 16 bit IDE Hard Drive, upto 120mb, to the QL. 


Plugs into ROM slot. Software built in. 


Payment Methods 


Cheques (in UK pounds drawn on UK Bank), Postal 
Orders, International Postal Orders & EuroCheques 
(in UK pounds) payable to:- QUBBESoft P/D 


Cash in UK pounds is also acceptable. 


P&P Guide for PD & Shareware 


Qty UK Euro Zl Z2 Qty UK 
£4 -£'p £p 

13-15 1.50 
16-18 1.75 
2 i 2.50 2.75 19-21 2.00 

10-12 1.25 2. 3.00 3.25 22-24 2.25 


1.50 1.75 
2.00 2.25 


ZI 
£p 
3.50 
4.00 
4.50 
5.00 
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I have a 720 sector disk 
drive. Is it 40 track or 80 
track - how can I tell? (Mark 
Shaft, Leicester) 


It could be either. Both a 40 track 
double sided or 80 track single sided 
drive would format a disk to 720 
sectors. The easiest way to tell is to 
FORMAT a disk with the special 11 
character names available on most 
disk systems. First of all, format a 
with the 
command FORMAT 
FLP1_1234567890 (a name of 10 
characters or less). Note the number 


disk normally, eg. 


of sectors printed, which would 
usually be 720/720 sectors. Now 
reformat with this command: 
FORMAT ’*FLP1_1234567890” 
(note the asterisk as the eleventh 
character inside the apostrophes. If 
the resultant sector count shown is 
still 720/720, this means that 
formatting single sided made no 
change, so it is likely to be an 80 
track single sided drive. But if the 
resultant sector count is halved 
(360/360 sectors), it was a double 
sided drive so must have been 40 
track double sided. Most people 
with 720 sector drives assume they 
are 80 track single sided, but 
experience has shown that QL users 
are more likely to have 40 track 
double sided drives than 80 track 
single sided. If in doubt, avoid these 
types of drives since many software 
suppliers for example will not be 
able to supply on these two formats. 


How can I add a mouse 
system to my QL? (John 
Staples, Nottingham) 
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There are four main types available. 
The original system was the QIMI, 
now available from the user group, 
Quanta (see page 8). It consists of a 
small circuit board which is installed 
inside the QL. You can then plug in 
an Atari style mouse. Generally 
speaking, it will work only with 
pointer driven software such as 
QPAC2. The second system is the 
Serial Mouse, by Albin Hessler. 
This consists of a disk of software 
and adaptor lead for a PC style 
mouse to plug into a serial port on 
the QL. Again, this is mostly used 
with pointer driven software, but 
more recent versions can copy the 
cursor and space/enter key presses 
of the keyboard too, making it 
useable to some extent with older 
cursor-key or joystick operated 
software. This is available in the UK 
from Dilwyn Jones Computing (see 
page 12). Thirdly, Adman Services 
(0952) 255895, 53 Gilpin Road. 
Admaston, Telford, Shropshire, TF5 
OBG supplies another PC mouse and 
software Simon 
Goodwin. This one can operate like 
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cursor key presses, though more 
recent versions are said to work 
with pointer driven programs too. 
The fourth type is a pure cursor key 


copier mouse which plugs into the . 


CTL (joystick) ports on the QL, 
called the Mersey Mouse, produced 
by members of the Merseyside OL 
user group. You may also come 
across an older mouse system called 
ICE. This is no longer supported by 
software developers. 


I have some _ programs 
where the instructions tell 
me to use ’Config’ to 


configure certain aspects of 
the software. What does this 
mean? (Colin Lamb, Somerset) 


CONFIG is a program supplied with 
many ‘pointer driven’ programs, 
which are controlled by moving a 
small pointer (usually a little arrow) 
across the screen to point to an item 
on the screen. These programs 
usually have some special 
information built in to tell the 
program which disk drive to use, or 
what type of printer is supported, 
for example. By starting the 
program called CONFIG (usually 
with the EXEC or EXEC_W 
commands) and telling it to load the 
details of a program you specify, 
you can look at this information and 
change it as required. Since 
CONFIG makes actual changes 
insde the program itself, always do 
this on a copy of the original 
program (keep the original master 
disk safe in case something goes 
wrong and you have to make 
another copy). 


LATE NEWS 


Software87 has produced a 
new version of Plus4, their 
wordprocessor. The new 
version (V4.1) contains 
several improvements on V4 
and also has an integrated 
manual. A special version of 
Plus4 is also available for 
SMS2 users. For further 
details contact Software87 
(071) 4859008, 33 Savernake 
Road, London, NW3 2JU. 
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MIRACLE SYSTEMS | 


Briefly... 


* 3 Times Faster 
* 68020 processor 


* 4M bytes of RAM 


* CENTRONICS port 
* 2 Disk drive ports 
* 2 Year warranty 


* £375 (£325) 
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What is it ? 
This is the first major revision 

of our highly successful Gold Card. 
We have replaced the 68000 with a 
68020 so programs run about 3 times 
faster and have expanded the memory 
to 4M bytes. 


Other improvements include a fast 
CENTRONICS printer port, 2 double 
disk drive ports, virtually crash-proof 
clock and a socket to optionally 
connect 5V. We also are providing a 
Centronics printer cable at no 
additional cost. 
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SUPER GOLD CARD 


“The Pathway to Future QL Development” 


The deal... 
The price is £375 inc. VAT (£325 
outside EU) which covers postage, 
2 year warranty and 14 day money 
back guarantee. We can upgrade your 
Gold Card for £225 (£200 outside 
EU), or trade in your Trump Card 
(£50), Super Q Board (£40), or other 
memory expantion (£25) against the 
purchase price. 


Additionally, you can trade in your 
QL Centronics (£15) or Disk Adapter 
(£10) or both. 


We are happy to accept payment by sterling cheque made payable to "MIRACLE SYSTEMS", or by quoting your 
MASTERCARD/VISA/SWITCH credit card number and expiry date (SWITCH card holders please also quote issue 


number). 


Order From... 


MIRACLE SYSTEMS LTD 


20 Mow Barton 


Yate, Bristol BS17 5NF 


UK 


Recycled Items... 


Gold Card £150 
QL Centronics £ 413 
Disk Adapter £ 10 


(Recycled items carry a 1 year warranty.) 
TELEPHONE/FAX: (0904) 423986 


MIRACLE SYSTEMS 


OXL 


See below for GOLD CARD Our NEW address: 
upgrade deal ! Now With MIRACLE SYSTEMS LTD 
20 Mow Barton 


Call for other upgrade paths. SB A SIC Yate, Bresral BS17 5NF 


SuperBasic Compatible Interpreter 


= 68EC040 
" 4M or 8M of RAM 
* Multitasking SBASIC 
= QL Network ports 
= Toolkit II 
* QDOS or MSDOS floppies 
* Uses PC's keyboard, floppy & 


hard disks, parallel/serial ports 
and mouse. 


This is the card that plugs into a standard 8 or 16 bit ISA slot on a PC and allows the PC to run QL programs - FAST. A 
new QDOS compatible operating system from Tony Tebby called SMSQ, which is supplied on a disk, includes Toolkit IT 
and gives you the familiar QL environment. SMSQ includes SBASIC a multitasking SuperBasic compatible interpreter. 


Installation is simple; plug the QXL into a spare slot and copy 2 files from the supplied disk onto the hard drive and you’re 

-~ceady to go. From the DOS prompt type QXL and the PC will transform itself into a QL before your very eyes. If at any 
stage you wish to return to DOS just press CTRL-ScrollLock. You can laterfesume the QL session by typing QXL/ which 
takes you back to where you left off. 


For POINTER ENVIRONMENT programs SMSQ can be configured to handle 3 screen resolutions in addition to the 
standard 512x256 QL screen. Your PC must have EGA or VGA graphics. EGA allows 640x350 whereas VGA also allows 
640x480. Most SVGA cards will allow SMSQ to use 800x600 as well. 


A QXL fitted with 4M bytes of RAM costs £380 including VAT (£330 outside the EU) and the 8M byte version is £495 
(£430 outside the EU). Prices include postage, our 2 year warranty and a 14 day money back guarantee. Software updates 
are supplied free of charge and sent out automatically. 


Alternatively send us your GOLD CARD plus £230 (£205 outside the EU) for a 4M byte QXL or send us your GOLD 
CARD and £345 (£305 outside the EU) for an 8M byte QXL. 


We are happy to accept payment by sterling cheque made payable to "MIRACLE SYSTEMS", or by quoting your 
MASTERCARD/VISA/SWITCH credit card number and expiry date (SWITCH card holders please also quote issue 
number). 


TELEPHONE/FAX : (0904) 423986 


16MHZ 68000 | 
HIGHSPEED | 
PROCESSOR | 
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QL GOLD CARD 


Recycled Gold Card £150 inc. (£125 outside EC) 


This is the expansion that has been revolutionising the QL. It is very easy to fit , it simply 
plugs into the expansion port at the left hand of the QL, and once fitted it will instantly 
increase the execution speed of the QL by about 4 times due to the presence of a 16MHz 
68000 on board. There is 2M of fast 16 bit RAM of which QDOS sees a contiguous 
1920K. The remainder is used for shadowing the QL’s ROM and display memory and for 
the GOLD CARD’s own code. 


There is a disk interface which can access 3 mechanisms (4 with the DISK ADAPTER) 
of three different densities, DD (double density, 720K), HD (high density, 1.44M) and 
ED (extra high density, 3.2M) in any mix. The disk interface connector is the same type 
that was fitted to the Trump Card so most QL compatible disk drives can be used. 


Please note: that DD drives still give a capacity of 720K per diskette. 
Our DUAL ED DISK DRIVE allows the GOLD CARD to access DD, 
HD and ED diskettes. 


Another feature is the battery backed clock When the QL 1s switched on the contents of 
the clock are copied into the QL’s clock so that the time and date are correct. The 
firmware in the ROM gives the GOLD CARD all the functionality of the Trump Card 
like TOOLKIT II and there is a sub-directory system for floppy and RAM disks. 


Physically the GOLD CARD is about half the size of the TRUMP CARD and so fits 
almost all within the QL. Its current consumption is well under allowable maximum so no 
special power supply is required. The GOLD CARD comes with a 14 day money back 
guarantee and a | year warranty. 
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This article is a review of 
version 5.21 Plus 3 (what does that 
mean ?) of the DEA disassembler, 
written by Marco Ternerlli. 

Many reviewers get supplied 
with a free copy of the program 
under review and get to keep this 
copy once the article is done /our 
normal policy] - in most computer 
magazines that is. This review is of a 
copy of the program that I actually 
paid for with my hard earned cash. I 
bought the program to assist me in a 
fairly major job I am doing for one 
of the larger QL _ Software 
companies - look out for 
forthcoming releases. No names yet 
! 

I already have a number of 
disassemblers, and while each one is 
good at what it does, DEA has to be 
the most up to date and complex 
beast of them all. I use each one 
where I think it is applicable, they 
are tools after all, to be used as and 
when desired - but the right tool for 
the job. 

DEA comes with a 52 page 
manual that was written by an 
Italian, Davide Santachiara of 
Ergon. The translation has been 
improved by RWAP Services. The 
manual is not bad as manuals go, I 
have seen a lot worse, but I think it 
is a bit thin for the complexity of the 
program. Perhaps more _ tutorial 
could have been given for new 
users. 

That apart, I have no problems 
with the manual, Looking at it in 
comparison with the actual program, 
I think that it would be quite a 
horrendous task to write a manual 
that was able to cover everything in 
depth and still be usable at the same 
time. 

Enough said about the manual, 
on to the program. DEA is a Turbo 
compiled SuperBasic program, the 
file is approximately 194 kilobytes 
long and one can only try to imagine 
the size of the original source code ! 

As disassemblers go, DEA 
knows almost all there is to know 
about ODOS and the OL. It knows 


about the system variables, 
SuperBasic variables, Things, QDOS 
vectors, Traps both QDOS and SMS 
and QPTR, ROMs, ROM image 
files, Error codes BP_INIT tables 
etc etc etc and when it comes across 
one in the code, it can track the 
parameters and use them to find 
where the structures used are held 
and dissassembles these correctly as 
well. Basically, DEA does about 
98% of the work involved in 
decoding a machine code program 
back to an assembly language source 
file. 

There are a couple of things 
that upset DEA, one of these being 
self modifying code (nasty stuff) 
such as Turbo compiled programs, 
but on the whole, DEA can cope 
with just about anything you care to 
throw at it. Some programs, such as 
compiled C or  Oliberated 
SuperBasic programs will need some 
work on your behalf after the source 
has been produced, but a lot less 
than with other Disassemblers. 

DEA comes with a boot file 
that loads up 2 extension files and 
then EXECs the program. The first 
extension file is the usual Turbo 
Toolkit Runtimes and the second is 
a smaller toolkit containing a 
number of base conversion 
functions. If you normally have 
Turbo Toolkit loaded, you probably 
won't need the first file If you have 
Toolkit 2 activated. you will not 
need the second. 

Once into the program and 
past the imitial screen, you are 
presented with a small menu that 
asks where to find the code that is to 
be disassembled, the options here 
are : In Memory, On a file or Ina 
ROM. The option to quit is also 
allowed here. 

DEA allows just about 
anything to be disassembled, with 
the above caveat on self modifying 
code. One very handy facility is the 
ability to get a directory listing, 
simply by typing in the device name 
and a question mark when prompted 
for a filename, as DEA doesn’t use 
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the QMENU extensions. 

DEA uses its own inbuilt 
menus and non-destructive 
windows. Menu options can be 
selected by moving the cursor up 
and down until it is positioned over 
the choice you want, then pressing 
the SPACE or ENTER keys. If the 
menu has an ’S’ in the top left 
corner of its title, it will allow on a 
Single choice to be made. Multiple 
choice menus have an ’M’ in the top 
left and these will not actually do 
anything until you get around to 
pressing ENTER. The SPACE key 
simply adds another choice to the 
list. 

In both types of menu, a 
choice can also be made simply by 
pressing the letter or number shown 
at the start of each entry. 

The main menu is first to be 
shown, and is a single choice menu. 
This gives you the choice of how the 
disassembly will proceed. Among 
the options, the one that DEA 
thinks is the most suitable will be 
highlighted for you - this helps 
reducethe number of key presses a 
user has to make in order to get 
from binary code back to source ! 

In most cases, the option has 
to be MULTI-LEVEL PARSING. 
as this is where all the hard work is 
done. In this option, DEA has up to 
7 levels of parsing where it checks 
through the code it is disassembling 
to see where it can fill in the blanks. 
As it goes, the memory map is kept 
updated. provided you have this 
option turned on, of course. 

The memory map is a small 
window which displays the progress 
of the disassembly. A line of pixels 
represents the entire code file, and 
each pixel represents a fraction of 
that code, under the map, an 
information section tells you how 
much code is represented by a single 
pixel. 

As the decode progresses, 
more and more of the pixels are 
filled in and from time to time, 
change colour, White pixels are bits 
of the file being decoded, green ones 
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show which bits of the file have 
been completely decoded and black 
is still to be done. 

DEA can follow the code 
through, as if it were executing it, or 
it appears that way, keeping a note 
of routines called in the code or in 
QDOS. Any routine called by the 
program that DEA has internal 
knowledge about, will also have any 
relevant data structures decoded as 
well. For example, a call is made to 
TRAP #2 with DO = 1, to open a 
file, DEA knows that the trap 
requires a parameter in AO and so it 
will look for the filename preceded 
by its word length and decode that 
automatically. Other internal 
structures are known about and 
decoded as required. This takes 
much of the work out of decoding a 
program. 

Each of the 7 levels of parsing 
carry out a specific task. Some levels 
are carried out once only, others 
might be carried out many times. 
The seven levels are :- 

Level 1, Main Parsing - this is 
performed once only and starts at 
the address you have specified as 
the start of the code to be executed, 
and performs a dataflow analysis on 
it following the calls to subroutines, 
branches etc in the program. 

Level 2, Config Data - after 
level 1 parsing has been done, DEA 
will look for CONFIG data blocks in 
the program. If any are found, they 
will be decoded as they are found. 

Level 3, Undecoded Label 
scan - If there are areas of code not 
decoded by any previous levels of 
parsing, this level tries to decode 
each as proper code. If it comes 
across an area that it cannot 
recognise as code, it assumes data, 
but more of this in level 6. DEA 
then carries on with these new bits 
of code and attempts to parse them 
as well. An undecoded label is an 
address in the code file that has 
been referred to in a previously 
decoded area, but which cannot be 
automatically understood. For 
example, some code carries out an 
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LEA.L address,AO and has been 
decoded by DEA. At this stage, 
there may be no clues in the 
previous or following instructions to 
give DEA a hint as to what the code 
or data at ’address’ actually is. DEA 
will try to decode it as assembly 


code, and if there are no errors, will. 


assume that it was code - the user 
has not been asked for help yet. 

Level 4, Skipped Address Scan 
- once DEA has finished at level 3 
and has no more labels to examine, 
it searches for bits of the file that it 
currently has no information about. 
Tt tries, once again, on its own, to 
classify these areas as code or data. 
Any areas of code, lead to the 
parsing process getting going again 
and this could lead to some more 
skipped labels, so, DEA starts 
another level 3 scan. DEA will 
happily switch between level3 3 and 
4 until it can do no more. 

Level 5, Search New word 
strings - Any area in the memory 
map that are still black could 
containing data. DEA now scans 
these areas for QDOS word strings. 
These being a word giving the 
length of the following string, 
followed by the characters of the 
string. This option can request user 
intervention. There is a menu option 
to ask for confirmation of any 
strings found. Assuming that at least 
1 string has been found, DEA gues 
back to level 3 to start parsing again. 
Tf not, level 6 is entered. 

Level 6, Retry Labels - this is 
similar to level 3, but this time, 
DEA is looking for data, not code. 
At this stage, DEA should have 
decoded a fair part of the file. If any 
areas are now decodes, level 3 is 
started again to try to get some 
more out of the file. If not, DEA 
could need some help. 

Level 7, Search New Code 
Start - this is where the user finally 
has his or her say in the decoding 
process. DEA has done as much as 
it can, but now needs help. Any 
black areas in the memory map are 
examined and the screen shows a 
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decode as data on the right and a 
decode as code on the left. 

The user then can move the 
cursor around in either code or data 
to show DEA where the next bit of 
parsing is to begin from. This is 
basically what you would be doing 
with other disassemblers which do 
not have DEA’s intelligence. You 
identify to DEA what each of the 
unknown parts of the code file are, 
and DEA takes that information and 
then starts parsing again. 

For each part that you tell 
DEA about, it will then parse that 
are according to your instructions. 
Code areas will cause the multi level 
parsing to be carried out until DEA 
gets stuck again. Once more, you 
supply a clue. This goes on until you 
abort DEA or there is noting left to 
decode. You can now select to 
generate the full disassembly from 
the main menu. 

In addition to being able to 
completely disassemble a program 
file. DEA can be used to extract 
certain routines from toolkits or 
from the QL’s*own ROM. As with a 
normal disassemble, you specify 
where to find the code and its start 
address etc. From the main menu, 
enter the Keyword Manager. 

Another menu is shown and 
the most logical choice is 
highlighted, this beimg to ’Edit 
Keywords’. At this point, you type 
in the name of any Procedure or 
Function that you wish to 
disassemble or extract. 

This is an area that caused me 
some trouble at first. DEA will 
ignore you if your code start address 
and length does not cover the start 
address of the various keywords that 
you wish to examine. To extract 
from the QL’s on ROM. the start 
address is 0 and the length is 48K 
(DEA accepts the 48K or 49152 
value, very handy). 

Another problem I had, was 
that the prompt asks for a keyword 
to be prefixed with an ’at’ sign (@) 
if already resident. If you do this, 
the keyword will not be included for 
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disassembly. What will happen is 
that you will be given its starting 
address in the ROM. This is useful 
for the main disassembly process, 
but confused me for a while ! (Read 
the manual properly !!!!) 

Type in all the various 
procedure and or function names 
and tell DEA whether they are 
procedures or not. DEA assumes a 
function for any keyword that is not 
a procedure. 

If you enter a keyword that 
starts in the code area that DEA is 
examining, you will be told its 
address and the name will be added 
to the list of keywords being looked 
at if you specify that it is to bee kept 
track of. 

DEA must be given the 
keyword in the proper case. ’dir’ is 
not the same as ’DIR’, beware. 

Pressing ENTER only in 
response to a prompt for a keyword 
name stops the input and you are 
asked if you wish to parse the 
keywords you have selected. If you 
reply Y, the parsing setting menu is 
displayed with most of the options 
highlighted and, as usual, the most 
logical choice selected. Simply press 
ENTER to extract the keyword 
code. It really is this simple ! 

At the end of the parsing, you 
can choose from the Keyword 
Manager menu, to create a file of 
source code. This option is the most 
logical choice, and DEA is just 
waiting for you to hit ENTER or 
SPACE to select it. The output from 
DEA can be sent to the screen, a 
file or a device such as a printer. 

The source code generated can 
then be reassembled to produce a 
smaller version of the original 
toolkit but you should be aware that 
this must only be for your own use - 
extracting other people’s code for 
commercial use is in breach of 
copyright. You must have 
permission from the owner of the 
copyright to use their code for any 
purpose. 

The generated source can be 
displayed on the screen, but, if it is a 
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long file, don’t ! The ESC button 
does not seem to be scanned for, so 
the whole disassembly must be 
listed before you regain control. 

This review covers only a few 
basics of the program. A full review 
would take up far too much space in 
the magazine and keep me busy for 
wecks. 

I can say that I like DEA a lot, 
I am glad to have paid for it and it is 
very, very useful in what I do. It has 
its foibles, and the ones I have noted 
are: 

Generating code to the screen, 
ESC cannot be used to abort the 
code generation. I don’t particularly 
like the need to enable the “ESC 
while parsing’ option so that I can 
escape from a large decoding 
session. But once found, it is easily 
set. 

When entering numbers for 
addresses, sizes etc, you can enter 
them in decimal, hex or as a number 
followed by K to signal kilobytes. 
The one place this doesn’t seem to 
be liked is when altering the code 
length as DEA simply buzzes at you 
if you use the ’k’ format. 

Sometimes when decoding a 
file, during the level 7 parse, DEA 
shows a totally blank screen then 
puts up the menu for me to select a 
code or data style ! As nothing has 
been shown, how can I tell ? 

I am sure that im a program as 
vast and complex as this one is, 
there could be a few bugs still to be 
found and ironed out. I think that 
anyone who is serious about 
developing code on the QL, or its 
derivatives, would do well to obtain 
a copy of DEA. If you do, be 
prepared to put a bit of effort into 
using it. It is not a simple program 
to use but it is well worth learning 
how to use it. 

The manual is quite good and 
there is a small, perhaps too small, 
tutorial section which shows how to 
disassemble the runtime Turbo 
toolkit. DEA doesn’t take long to do 
it either and very little effort is 
required. Another part of the 


25 


tutorial shows how to decode a file 
about. which you have no 
knowledge. 

There are some programs it 
doesn’t like. I threw a C68 compiled 
program at it which caused it to get 
in a knot, but then again, did I tell it 
something about a piece of the file 
that might not have been quite 
correct ? 

In order to get a further plug 
in for DJToolkit, DEA completely 
disassembled it in 40 seconds 
without needing any input from me. 
The final file was approximately 46 
kilobytes long and matched up to 
the original, even down to bits in the 
file that are not called or used in any 
other part of the toolkit. DEA found 
them all, I’m impressed. I am off to 
see how it can handle Psion Chess. 


Norman Dunbar 


DEA costs £26.00 (+£1 for non 
UK countries) and is available 
from DiIlwyn Jones Computing 
(0248) 354023, 41 Bro Emrys, 
Tal-Y-Bont, Bangor, Gwynedd, 
LLS7 3YT, UK or Ergon (x-39- 
522-70409) c/o D-.Santachiara, 
Via Emilio De Marchi 2, 42100 
Reggio Emilia, Italy. 
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MINERVA HERMES 


A replacement QL co-processor for the 
QLs awful IPC 8049 


- Do you get keyboard bounce? 

- Do you find fast serial input unreliable? 

- Do you want to connect a faxmodem at 19200bps and 
and send and receive FAXES and/or data. 


The ULTIMATE system upgrade 


MINERVA RTC (MKII) + battery for 256 bytes ram, 
CRASHPROOF clock & IC bus for interfacing. Can 
autoboot from battery backed ram. Quick start-up. 


OTHER FEATURES COMMON TO ALL VERSIONS 


DEBUGGED operating system/ autoboot on reset or 
power failure/ Multiple Basic/ faster scheduler- 
graphics (within 10% of Lightning)-string handling/ 
WHEN ERROR/2nd_ screen/TRACE/ non-English 
keyboard drivers/ “warm” fast reset. V1.97 with split 
OUTPUT baud rates (+ Hermes) & built in Multibasic. 


If you can say one YES , then you need HERMES 


- 19200bps RELIABLE serial input - NO QCONNECT. 
- Independent input baud rates - use serial mouse & print 
- Stops keyboard bounce (unwanted repeat chrs) 

- Improves ’fuzzy’ and ’random’ sound 

- Provides extra input/output lines 

- Key click 


lst upgrade free. Otherwise send £3 (+£5 for manual 
if requd) . Send SAE, Minerva + disk/3 mdvs. 


MK... £40 RTC (MKID)... £65 


GOLD CARD (incl SUPER) compatible 
QL SPARES I-C Interfaces 
The J?C bus was designed by Philips to simplify 


Faulty QL board ( no plug-in chips)........... interfacing. Minerva MKII clock is driven by an [?C 
o) 5 Ae a chip, & a connector allows connection of other circuits. 
Keyboard membrane ....£9 Circuit diagrams .......... Our external circuits will interconnect without leads. 
sueapesedouSeosbeees 1377 PAL ............eceneeee Up to 5 interfaces can be powered off the QL. 
odearetaceesseceeh lO”. “8501 ULLAL. etic Parallel Interface gives 16 input/output lines. Can be 
used for logic level output eg model train controllers. 


Input direct to motor drivers (eg L293/L298)...... £25 


To fit, simply replace the QL 8049 or 8749 chip 


£25 including manual/software 


Other components/(sockets etc) please phone 


; Analogue Interface Each gives 8 analogue to digital 
QI REP AIRS inputs, and 2 digital/analogue outputs. For temp 
measurement, sound sampling etc................... eee ee £30 

Data sheets. (analogue/parallel I2C chips).....0..0..... £2 


Control software/manual (Superbasic extns).............. £2 
Fixcd price for unmodified QLs, excl microdrives. QLs (First interface purchase includes free 15D/9D Icad) 


tested with Thorn-EMI rig and ROM softwarc COMPUTER CLEANER 
£27 including 6 month guarantee 


High Spec AC mains filters and spike removers 


QBBS - UKs first_QUL scrolling Bulletin Board 


Megabytes of files. Messages to/from UK/Belgium/ 
Holland/USA/Germany for a UK phone call. 
TANDATA callers add SIX zeros (000000) or wait 
for 3 seconds of modem tonc if dialling manually. 


0344-890987 (up to V32bis) 


All in standard 3-pin devices and are plug-in 
NO WIRING REQUIRED. In their 10th year of 
production - as old as the Sinclair QL 


2-way adaptor...£14_ 3-way adaptor..£18 
4-way trailing socket... £24 


| Prices include post & packing (UK only). Payment by Mastercard/Visa/Access/Eurocard/cheque/postal orderfPO | 
Giro transfer (58 267 3909). MAIL ORDER ONLY - no callers without ringing first. Ring for overseas prices. 


Holly Corner, Priory Road, ASCOT, Berks, SL5 8RL 


Tel: 0344-890986 Fax & BBS: 0344-890987 
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Using BP_LET within 
SuperBasic extensions. 


As a follow up to my earlier articles 
on using the QL’s Maths stack, here 
is a small example of how to use the 
BP_LET vector. For some reason, 
my articles seem to follow on from 
DITOOLKIT (plug plug !) as a 
recent upgrade required that I find 
out more about this useful vector 
and now I will attempt to pass that 
information on to you. 


BP_LET is mentioned in all the 
good QDOS manuals, magazines, 
books etc, but never seems to be 
explained, this article will hopefully 
do just that. I will also develop a 
very small (and very useless) 
procedure to show how BP_LET is 
used. 


What does BP_LET do exactly ? 


BP_LET allows you to modify the 
value of one. or more, of the 
parameters passed to a procedure or 
function. In most programming 
courses, this is treated as a no go 
area and is considered to be even 
more of a sin than using GOTO in a 
program. 


A function should take some 
parameters. do something with them 
and return a single result without 
changing the parameters that were 
supplied. A procedure should take 
some parameters and carry oul 
some form of action using those 
parameters. It should never change 
the parameter values. 


BP_LET allows the rule books to be 
discarded and we can do anything 
we like. 


We can write a procedure that takes 
one or more parameters, carry out a 
few actions using them and then 
return each parameter with a new 
value. That should really upset the 
purists ! 
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As you may be aware, in 
SuperBasic, if you want to avoid 
having parameter values changed, 
you supply them in brackets as in 
the following :- 


1000 REMark unchanging parameters 
1005 : 

1010 CLS 

1015 first = 100.456 

1020 second$ = ‘Hello’ 

1025 third’ = 2468 

1030 : 

1035 PRINT ‘BEFORE’ 

1040 PRINT first, second$, third’ 


1045 process (first), (second$), 
(thirds) 
1050 : 


1055 PRINT ‘AFTER’ 
1060 PRINT first, second$, third 
1065 : 


1070 : 

1075 DEFine PROCedure process(a, b$, 
C3) 

1080 a=a*2 


1085 b$ = b$ & 7 Mum !’ 
1090 cé = ct / 2 
1095 END DEFine process 


If you type this in as it is above and 
run it, you should see the following 
on the screen :- 


BEFORE 

100.456 Hello 2468 
AFTER 

100.456 Hello 2468 


As you can see, the parameters have 
not changed even although they 
were apparently altered within the 
procedure called PROCESS. What 
has happened is that the OL made 
copies of the variables values for use 
by the procedure and saved the old 
values while it was in the procedure. 
On exit, the changed values were 
discarded and the originals were 
restored, the end result is no 
changes. 


Now remove the brackets in line 
1045, the call to PROCESS, and run 
the program again. This time the 
result is :- 
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NTERRUPT 


BEFORE 

100.456 Hello 2468 
AFTER 

200.912 Hello Mum ! 1234 


Note how the parameters have been 
changed ? 


In the first example, the parameters 
were saved because the brackets 
around them fooled the QL into 
thinking that they were expressions 
and not variables, and as expressions 
cannot be changed, they were not. 
In the second example, the lack of 
brackets caused them to be treated 
as variables and the changes were 
carried out. 


In assembly language, we can do 
similar things. Most procedures and 
functions are written so that any 
parameters supplied to it are 
unchanged when the procedure or 
function exits. This is like our first 
example. 


We can use the BP_LET vector to 
cause the procedure or function to 
behave like our second example 
where the parameters are changed 
by the routine. 


Calling BP_LET 


When calling BP_LET. certain 
registers require to be set. These are 


A1.L Pointer to a tidy maths stack 


* holding a result. 


A3.L Pointing to the name table 
entry for the parameter to be 
changed. 

BV_RIP(A6) Holding the top of the 
maths stack. 


In order to set up a call to BP_LET. 
the maths stack must be tidy and 
holding a single value in a manner 
very similar to what it would be if 
this was a function just about to 
retumm to SuperBasic. (See previous 
articles on the maths stack for full 
details) 
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BV_RIP(A6) should be holding the 
address of the top of the maths stack 
as normal. Whether A1l.L must be 
also holding the same value is 
unknown, but it is safe to assume 
that it should in accordance with 
normal rules. 


A3 should be pointing at the name 
table entry for the parameter to be 
changed. From the name table, 
QDOS finds out what type of 
parameter this is and the result on 
top of the maths stack must match 
the parameter. If A3 points at a 
string, the maths stack must be 
holding a string etc. 


All you need to do now is call 
BP_LET and on return check DO.L 
for errors. If an error occurs, it will 


few nn wn ew won nn eon nnn eno — 


be BAD PARAMETER (-15) and 
usually means that A3 was pointing 
at a parameter that did not have the 
same type as the value on the maths 
stack. 


On return from BP_LET, DO holds 
the error code, as described above, 
D1, D2, D3 are corrupted as is AO, 
Al and A2. D4 to D7 and A3 to A7 
are preserved. This means that if 
your routine requires to use 
BP_LET more than once, you will 
need to take care of all these 
registers. 


BV_RIP(A6) is preserved so Al can 
be reset from there if the maths 
stack is required again. 


eee mmewownn nn nemo on wenn see eoe x 


* A small demo of BP_LET - used to return the current QDOS version * 
* in a string variable passed as a parameter. * 


* Written for QREVIEW Magazine by Norman Dunbar 


x June 1994 
* Copyright Norman Dunbar 


fom econn mma weno owns oosenw ema esose 


* Permission granted to anyone to use this code for any purpose, ae x 
* it public domain, commercial or anything else. 


BV_RIP equ $58 
BV_CHRIX equ S11A 
BP_LINIT equ $110 


few nmnenoenwe mm eeoooe one o eee sowornneee 
section code 
start lea.l def_block,al 
move.w BP_INIT,a2 
jsr (a2) 
rts 


def_block dew 1 
dc.w  qdos-* 
dce.b  6,’BP_LET’ 
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Offset for maths stack holder 
Vector for claiming stack space 
Vector to initialise new procs 
Trap key for MT_INF, trap #1 
Vector for BP_LET ! 

Code for bad parameter error 


Pointer to definition block 
Vector to be called 

Do it 

Exit 


Only one procedure 


Where it starts 
What it is called 
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An example procedure 


This will be a very simple example. 
A procedure will be written that will 
1. Make 
parameter. 
2. Make room on the maths stack 
for a 4 byte string and its word size. 
3. Call the MT_INF trap to get the 
current version of QDOS. 

4, Stack the OQDOS version. 

5. Place the QDOS version into the 
supplied parameter. 


sure that it gets 1 


The code on this page is written for 
the QMAC assembler, available 
from Quanta. It should be ok on 
others, but I am not a frequent user 
of other assemblers so I cannot be 
certain. The comments in the code 
should explain what is going on. 


When you have assembled the code, 
it comes out around 96 bytes, load it 
into you QL as follows :- 


addr = RESPR(96) 
LBYTES 
CALL addr 


flp1_bplet_bin, addr 


Obviously, you will replace the 
filenames I have used above with 
the ones that apply on your system. 
Now all you have to do is type :- 


BP_LET a$ 


and whatever characters used to be 
held in a$ are no more. A$ now 
holds the 4 character version of 
QDOS, to see it, PRINT a$. If a$ 
did not exist at the time of calling 
BP_LET, it is created for you. 


Should you make a mistake, and call 
"BP_LET a%’ instead, a couple of 
things will happen. First, a% will be 
set to 4, the word that is on the 
stack which holds the length of the 
string. Second, the maths stack 
would be left in an untidy state if 
this had been a function, a crash or 
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SZ 
dew 0 End of procedures 
dew 0 No functions 
dew 0 End of functions. 


* The procedure starts by checking that there is only one parameter * 
* supplied. It must be a string, but BP_LET will check that for us * 


Se a re ec a a a A a a 


qdos move.l a5,dl Pointer to last parameter 
sub.l1 a3,dl Pointer to first parameter 
cupi.l #8,d1 One parameter = 8 bytes in name table 


beq.s param_ok 


bad_paran moveq #ERR_BP,d0 Oh dear, bad parameter 
rts Bale out to SuperBasic 


* If we have a single parameter, A3 points at it position in the name * 
* which is what we want. Al is undefined. BV_RIP(A6) is a valid stack * 
* so load up Al with this address, claim some stack space and set the * 
* stack pointer in Al to point to the result space on the stack. 


oe he OR SS OOK 


param_ok moveq #6,d1 6 bytes required for result 
move.l BV_RIP{a6),al Preload stack top into Al 
move.w BV_CHRIX,a2 Get the vector 
jsr (a2) Get the space, no errors occur 
move.] BV_RIP(a6),al New stack top 
suba.1 #6,al Hake room for result 
move.l a3,-(a7) A3 gets trashed by HT_INF trap 


* it at AL. 

Ran nweemeewan eee ee remem wenn neers eee eee eee ewe ceown nwo se ewewennnn= 

ntinf moveq #HT_INF,d0 The trap we wish to set 
trap #1 Go do it, no errors occur 
nove.w #4,0(a6,al.1) Stack string size = 4 bytes 
move.l d2,2(a6,al.1) Stack the characters 


* Now the result is on the stack, restore A3 so that it once more is * 
* pointing at our parameter’s name in the name table. Then call BPLET * 
* to put the value into our parameter. We are then done and quit. 


bplet nove.l (a7)+,a3 Restore our name table pointer 
nove.l al,BV_RIP(a6) Set new stack top for return 
nove.w BP_LET,a2 Get the vector 
jmp (a2) Call the vector, errors to SuperBasic 
END 
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something equally as nice would be 
just waiting to happen. The four 
characters stacked for the string 
have been left lying on the maths 
stack. This is not a problem here, as 
we have written a procedure and 
procedures tidy the maths stack on 
exit. 


If you call "BP_LET a’, using a 
floating point variable, you may well 
get a valid floating point number 
and the 6 bytes on the stack will be 
used to set its value. Some values 
can crash the QL if they make up a 
floating point value that is out of 
range of the QL’s normal floating 
point range. 


You must ensure that the correct 
type of parameter is supplied. Of 
course, you can check the parameter 
type within the procedure. On entry, 
A3 points to the first parameter in 
the name table and AS to the first 
byte past the last, both relative to 
A6 of course.To check which type of 
parameter has been supplied, all you 
have to do is check the appropriate 
part of the type word, which is at 
0(A6,A3.L) for the first parameter. 
The lowest 4 bits of the low byte of 
the type word hold the parameter 
type. These are :- 


0000 = Null 

0001 = String parameter 

0010 = Floating point parameter 
0011 = Integer parameter 


So, an instruction sequence like the 
following should make sure that the 
correct parameter type is supplied. 


move.b 1(A6,A3.L),d0 

Get the type word, lowest byte 
andi.b #%00001111,d0 

Mask out unwanted bits 

cmpi.b #1,d0 

Test for a string 

bne.s bad_paran 

Oops ! 


And that is about it. In the example 
procedure above, you may have 
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noticed that I never actually fetched 
the supplied parameter on to the 
stack. This is quite simply because I 
don’t have to fetch the current 
VALUE of A$ on to the maths 
stack, as I don’t care about it. All I 
need to know is where is it in the 
name table and A3 tells me this. 


Another point to note. If I wanted 
to alter the values of more than one 
parameter, I would have used JSR 
(A2) instead of JMP (A2) then on 


return, reset Al to BV_RIP(A86), 
added 8 to A3, to point at the next 
parameter in the name _ table, 
stacked my next result (optionally 
checking the parameter type) and 
called BP_LET again. It is that easy. 


If there are any other ’bits’ of 
QDOS that you wish to have 
explained, why not write to Bruce at 
the magazine and ask him, perhaps 
someone out there can come up 
with the information you require. I 


have done articles on using and 
abusing the maths stack and now 
using BP_LET, there must be other 
stuff people want to know about or 
don’t fully understand. If I can help, 
I will, if not, somebody else might 
be able to. If you don’t ask, you 
don’t find out, and besides, Bruce 
will be glad of the articles ! 


Norman Dunbar [Author of 
DJToolkit if you haven’t guessed by 
now] 


A 
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LEFT 
Chris Boutal 
(Geneologist) 


RIGHT 
Stuart Honeyball 
(Miracle Systems Ltd.) 


BOTTOM LEFT 
Minerva I'C Demonstration 


(TF Services) 


BOTTOM RIGHT 
Graham Thwaites 
(Grange Technology Ltd.) 
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ESCHER GRAPHICS DISK. 
DBMAN V3.6. 
* ERGON DEVELOPMENTS DEMO. 
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* O.T.P.I. POINTER COMMS PACKAGE. 
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* = New Or Updated Disks. 
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Burnley, 
Lancashire, 
England. — 

D BB10 3DZ. 


Tel. [ UK ] 01282 451854. 


I CAN NOW OFFER OVER 60 DISKS 
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SHAKESPEARE, HOMER, LEWIS 
CARROLL & MILTON. 


AMIGA QDOS EMULATOR. 
RELEASE 3.21. 
ONLY £3.50p. 
FULLY INCLUSIVE. 


PLUS 45 DISKS OF THE BEST 
ASSORTED QL PUBLIC DOMAIN 
& SHAREWARE 


Z80 128K SPECTRUM EMULATOR. 
XTENDER. ZX81 EMULATOR. 
APPLE ][ EMULATOR. 
C64 EMULATOR. 

QDOS READER. 

* ATARI 400/800 EMULATOR. 
* DRAGON 32 EMULATOR 
AMSTRAD CPC EMULATOR. 
SHOWOS. 

PSION 3 EMULATOR. 

* MACHINTOSH EMULATOR. 


MOST PC DISKS ARE £1.75p 
FULLY INCLUSIVE. 


QL Pre-Copied Disks Are From £1.75p Each, Inclusive Of Media And Return Postage. 
I Can Also Copy Onto User Supplied Media At £1.00p Per Disk Plus Return Postage. 


For A Catalogue Disk Which Details All PD & Shareware Offered And Also List 
Second-User Hardware, Software, Magazines & Books Available. Send A Formatted 


_ Pg Disk And Return Postage Or 4 X First Class Stamps. 

Worn ES © 
\ acl A Printed List Is Also Available, Send Large S.A.E. Along With ee) 
\, 7 4 X First Class Stamps. 2D) 


As of 29/09/94 14:20 a 


This listing is part of a set of useful procedures 
and functions which you can use in your library. | 4170 : : 
All are in structured BASIC, so there should be | 4180 REMark return number as string with given number of 
no problem with line numbers in GO TO | 4190 REMark decimal places, does not round off values 
statements etc. 4200 DEFine FuNction DECIMALS(value,places) 
4210 LOCal r$ 
DECIMAL$ 4220 r$ = value 


A function to help with formatting numbers to | 4230 dot = ’.’ INSTR r$ 

given numbers of decimal places, e.g. to ensure | 4240 IF dot = 0 THEN 

money values always show 2 decimal places | 4250 r$=r$ & '.! & FILLS(/0', places) 
after the decimal point. It does not round off | 4260 ELSE 

the value to the nearest decimal place, it merely | 4270 IF LEN(r$) > (dot+places) THEN 


ensures there is the right number of digits after | 4280 r$ = r$(1 TO dot+places) 
the decimal point. Call it with something like | 4290 ELSE 
PRINT DECIMAL$(’100’) to print 100.00, or | 4300 r$ = r$ & FILLS$(/0’, (dottplaces)-LEN(r$) ) 
LET money$=’$’& DECIMAL$(value) 4310 END IF 
ENABLE CURSOR 4320 END IF 


Turns on a cursor in the given channel. You | 4330 RETurn r$ 
may have to use CTRL C before the cursor | 4340 END DEFine DECIMALS 
starts to flash. Useful routines when attempting | 4350 : 
to compile a basic program which uses | 4360 REMark routine using undocumented cursor on trap to make 
INKEY$, for example, to ensure that if you | 4370 REMark cursor flash in given channel 
start a program with EXEC and use CTRL C j 4380 DEFine PROCedure ENABLE _CURSOR(channel) 
to switch to another program, you can actually | 4390 PAN#channel,0,115 
get back in! There is no cursor enabling | 4400 END DEFine ENABLE_CURSOR 
command (apart from INPUT) in basic. But j 4410 : 
with an undocumented PAN command j 4420 REMark this routine turns off flashing cursor in given channel 
discovered by Simon Goodwin, it is possible to | 4430 DEFine PROCedure DISABLE_CURSOR( channel) 
produce this facility. Both QlLiberator and | 4440 PAN #channel,0,116 
Turbo compilers have cursor enabling | 4450 END DEFine DISABLE_CURSOR 
commands in their basic extensions files, so this | 4460 : 
is redundant if you have a compiler. This PAN | 4470 REMark function which returns a string containing given 
command is not a documented feature of the | 4480 RENark number in other base specified (bases 2 to 36) 
OL, so although it seems to work on most | 4490 REMark e.g. PRINT CONVERTS(/255’,10,16) gives FF 
current OL rom versions, it may be removed | 4500 DEFine FuNction CONVERTS(num, from, tobase) 
from future versions! 4510 LOCal sum,num2$,char,digit ,conv$,remn, loop 
DISABLE_CURSOR 4520 sum = 0: num2$ = num: conv$ = ’’ 
Opposite routine to above, to turn off a cursor | 4530 FOR char = LEN(num2$) TO 1 STEP -1 
in a given channel. 4540 digit = CODE(num2$(char) ) 
CONVERTS 4550 : 
A function which converts a number from a | sum=sumt(digit-48-7% (digit>=65)-32*(digit>=97) )*(from*(LEN(num2$)-cha 
given base to another number base. Useful for | r)) 
converting between binary, decimal and | 4560 END FOR char 
hexadecimal, for example. Handles base 2 up to | 4570 REPeat loop 
base 36. Supply three parameters - the number | 4580 remn = INT(sum-(tobase*INT(sum/tobase) )+.5) 
to be converted (as a string), the base to | 4590 sun = INT(sum/tobase) 
convert from and the base to convert to. So to | 4600 conv$ = CHRS(remn+48+7*(remn>9))&conv$ 
convert decimal 255 to binary, use PRINT | 4610 IF sum = 0 : EXIT loop 
CONVERT$(’255’,10,2). Decimal numbers can | 4620 END REPeat loop 
be supplied as numbers, not strings is preferred. | 4630 RETurn conv$ 
The routine does not add leading zeros to pad a | 4640 END DEFine CONVERTS 
converted string to a given length, but it should | 4650 : 
be easy enough to write a small piece of code to | 4660 REMark make composite colour number (0 to 255) 
do this, eg. LET a$=CONVERTS | 4670 DEFine FuNction COMPOSITE(main,contrast ,stipple) 
(‘value’,from_base,to_base): PRINT | 4680 RETurn (64*stipple) + ((main ** contrast)#8) + main 
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FILL$(’0’,required_length-LEN(a$)) 
COMPOSITE 

Avoids the hassle of calculating composite 
colour numbers from the main, contrast and 
pattern colour values. This combines them into 
a three digit number from 0 to 255, which is the 
normal QDOS colour value. For example, a 
black and white stipple of pattern 3: PRINT 
COMPOSITE(0,7,3) gives colour 248. 

BREAK_STIPPLE 
Breaks a composite colour number down into 
main, contrast and stipple pattern values. Try 
reversing the above by seeing what comes out if 
you enter the value 248. 

SYS_VARIABLES 
Many toolkits have functions to tell you the 
base address of the system variables area. On 
original Sinclair roms, the system variables 
were at a fixed address, 163840 (decimal). Then 
Minerva came along and showed us this was 
not always the case. Fine, if you have a toolkit 
or Minerva. But it would be nice to have a 
routine which could work on all QL versions 
and take advantage of the extended Minerva 
VERS function which can tell us the base 
address even if the system variables are moved 
in memory to allow use of the second screen. 
The Minerva rom basic version always returns 
*JSL1’, so we can use this in an IF statement to 
*hide’? the Minerva specific command from 
ordinary versions of basic, so that those with 
Minerva can find the system variables when the 
second screen is in use. 

ADD _VAT 
Adds a percentage to a given value, useful for 
Value Added Tax (UK) calculations. Function. 
LESS_VAT 
Fnetion which returns a value minus the added 
VAT content. in other words, the VAT-free 
price. 
ROUND_OFF 
This function is similar to INT, but rounds off 
to the nearest value, for positive numbers, by 
adding 0.5 
LOGS 
A function which generates logarithms to other 
bases using the QL’s LN function. 
ODD 

A simple function which returns 1 if a value is 
odd, 0 if even. 

ROUND PLACES 
Rounds off a number to a given amount of 
decimal places. 


Dilwyn Jones 
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4690 END DEFine COMPOSITE 

4700 : 

4710 REMark break down composite colour number to main colour, 
4720 REMark contrast colour and stipple pattern number 

4730 DEFine PROCedure BREAK _STIPPLE( value) 

4740 main = value & 7 

4750 contrast = ((value && 56) DIV 8)**(value && 7) 

4760 pattern = (value && 192) DIV 64 

4770 END DEFine BREAK_STIPPLE 

4780 : 

4790 REMark function to find base address of system variables 
4800 REMark even in Minerva two screen mode, testing for ‘JSL1’ 
4810 REMark and using an IF statement to ‘hide’ Minerva specifics 
4820 REMark allows programs to take advantage of them where present 
4830 DEFine FuNction SYS_VARTABLES 


4840 IF VERS = ‘JSL1’ THEN 

4850 RETurn VER$(-2) : REMark Minerva system variables 
4860 ELSE 

4870 RETurn 163840 :; REMark on AH/JM/JS 

4880 END IF 

4890 END DEFine SYS_VARIABLES 

4900 : 


4910 REMark function adds percentage to original amount 
4920 REMark e.g. for VAT calculations 

4930 DEFine FuNction ADD_VAT(value,percentage) 

4940 RETurn value + (percentage*value/100} 

4950 END DEFine ADD_VAT 

4960 : 

4970 REMark opposite routine to deduct VAT from total 
4980 DEFine FuNction LESS_VAT(total , percentage) 

4990 RETurn (total*100) /(100+percentage) 

5000 END DEFine LESS_VAT 

5010 : 

5020 REMark round off number to nearest whole number 
5030 DEFine FuNction ROUND_OFF (number) 

5040 -RETurn INT(number+.5) 

5050 END DEFine ROUND_OFF 

5060 : 

5070 REMark return logs to other bases 

5080 DEFine FuNction LOGS(value,base) 

5090 RETurn LN(value) /LN( base) 

5100 END DEFine LOGS 

5110 : 

5120 DEFine FuNction ODD(value) 

5130 RETurn value-(2*INT(value/2) ) 

5140 END DEFine ODD 

5150 : 

5160 REMark round off number to given decimal places 
5170 DEFine FuNction ROUND_PLACES (value,places) 
5180 RETurn INT(value*(10*places}+.5) /(10*places) 
5190 END DEFine ROUND_PLACES 

5200 : 
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There have been many alternative 
BOOT programs published in 
various magazines. Nevertheless, 
few of them utilise MINERVA’s 
enhancements. Therefore this article 
is mostly for MINERVA users since 
it uses many of those enhancements. 
However, not wanting to appear 
ROMist, it will hopefully provide all 
users with some ideas on how to 
improve their BOOT programs. 


When I began to write this suite of 
BOOT routines, my main concern 
was to load all the jobs as quickly as 
possible. With the JS, and earlier 
ROMs, this was difficult to do. Only 
one SuperBasic program could be 
run at a time. This meant that 
everything has to be installed in a 
linear fashion, or compiling certain 
routines to gain extra speed. 


There are 2 other concurrent aims. 
These are to make the boot device 
invisible to the machine. That is, 
rather than assuming that all tasks 
would be loaded from FLP1_. the 
program would ask for one first. 
The code should also be 
ROM independent. This last aim 
conflicts with the desire for speed 
because it suggests that extra checks 
must be included in the code to cope 
with different set-ups. 


I also prefer the long-forms of 
commands and_ spread the 
instructions out to improve 
readability. However, this adds to 
the length of the code, slowing 
loading (and processing?). 


The first act of the BOOT program 
should be to install the TK2 EXTs 
and discover the boot device. There 
are in fact 2 possible ways to 
achieve this. If you have a 
MINERVA MKII, then you could 
put this code on the battery RAM; 
resulting in something like figure 1. 


This code has 3 limitations. 
TK2_EXT is embedded on the 
battery RAM which will cause 
problems if you wish to demonstrate 
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MINERVA BOOT 


your boot program on someone 
else’s machine. The BOOT file must 
be renamed BOOT MAIN, or 
similar, so that the BOOT program 
is not automatically loaded and run 
on start up. Also, there is only space 
for limited error checking of the 
device the user inputs. If you type 
’WI1_’ by mistake, this routine can 
not check for the mistake resulting 
in the BOOT program not being 
loaded. 


There is a minor problem in that 
when the next part of the boot 
program is loaded, if viewing on a 


Figure 1 
TK2_EXT 


WINDOW 512,256,0,0:CLS 
CSIZE 1,1 


INPUT\, ,’BOOT DEVICE ( FLP1_ ) ? ’;MS 


IF M$<>’’:PROG_USE M$ 
LRUN’BOOT_MAIN’ 


Figure 2 


122 TK2_EXT 


127 CSIZE #0, 1, 1: INPUT #0, \, ‘WHAT IS THE BOOT DEVICE ( FLP1_) ? '; 


DEVS \\ 


130 IF LEN( DEVS ) = 4 OR LEN( DEVS ) = 7 THEN LET DEVS = DEVS & ’_’ 
132 IF DEVS = '’ THEN LET DEVS = PROGDS: ELSE: PROG_USE DEVS 


monitor, the original windows are 
restored, thus, our first act must be 
to reset the screen (line 120) 


120 CLS: CSIZE 1,1 
130 LET DEVS = PROGDS 


Since we have changed PROGD$ to 
your choice, and have LOADed the 
main BOOT program, thus, resetting 
the variable M$, we must return 
your choice to a variable; DEVS 
(line 130). Why must we do this? 
Rather inexplicably, the device that 
EXEC and LRESPR use for default 
devices are different. Therefore, it is 
simpler to use a variable to hold the 
default device and use it whenever 
we wish to LOAD, COPY, EXEC, 
or LRESPR a file. 


35 


125 WINDOW #0, 512, 256, 0, 0: INK #0, 7: PAPER #0, 2: CLS #0 | 
| 


Alternatively the battery RAM code 
with more error checks and included 
as part of the main boot program, 
looks like figure 2. 


Please note that from now on, the 
line number ranges used are 
important and should be entered as 
printed. 


Line 130 and 132 perform a little 
error-trapping. The reason for 
checking the length of DEV$ to 
discover if it is seven characters long 
is because that is the length of 
DEV$ if you are to boot across a 


network (Ni _FLP1_) and have 
omitted the final underscore. One 
could also check that DEV$ contains 
a recognised device, ic. WIN1., 
FLP1_, MDV1_ etc. 


We use channel #0 because 
Minerva MKII users may like to put 
the default devices into the battery 
powered RAM, which means that at 
boot time, the default devices are 
automatically loaded into the 
variables. 


A main feature of this BOOT 
program is the use of Minerva’s 
Multi-Basic feature to speed up the 
booting process. But what exactly 
can be run from a Multi-Basic? If a 
Multi-Basic has been run as an 
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EXEC’d program, then when it 
finishes, QDOS will delete it and 
any jobs that are owned by it; so 
you can only EXEC jobs from a 
Mullti-Basic if you can find a way to 


MINERVA BOOT 


work), and you do not mind the loss 
of at least 32K of memory. 


If you LRESPR an extension, then 
that extension is only available to 


helpful. 


This leaves us with COPYing files 
and processing data. With a Gold 
Card fitted I started to copy help 


stop the EXEC’d Multi-Basic from that Multi-Basic and any jobs 
finishing (PAUSE -1 does not started from it. Again not very 


and parameter files to RAM disk. 
This task can be done from a Multi- 


Figure 3 - Main Boot Program 


137 LET M$ = VERS: LET V = 0 

140 IF M$ = ‘JSL1’ THEN LET V = 1 

160 LET x = RESPR( 2000 ) 

165 CSIZE #0, 0, 0: FORMAT #0, RAMI 500: CSIZE #0, 1, 1 


170 IF V THEN 

172 IF VERS(1) = ‘1.93’ THEN 

174 LET M$ = ‘RAMI MULTI_BASIC’: COPY DEVS & ’MULTI_BASIC’, M$ 
176 ELSE: LET M$ = ’PIPEP’ 

178 END IF 

180 EX MS;DEV$ & ’BOOT_COPY_TO_RAM>’ & DEVS: EX MS;DEV$ & ’BOOT_ERROR_MESSAGES>’ & x 
190 ELSE 

200 LET CMDS = DEVS: MRUN DEVS & ’BOOT_COPY_TO_RAM’ 

950 LET CMDS = x: MRUN DEVS & 'BOOT_ERROR_MESSAGES’ 

1200 END IF 


1222 INPUT #0, \, "WHAT IS THE SECONDARY DEVICE ( FLP2_ ) ? "; PROG$ 
1223 IF LEN( PROGS ) = 4 OR LEN( PROGS ) = 7 THEN LET PROGS$ = PROGS & '_’ 
1225 IF PROGS = '’ THEN DATA_USE 'FLP2_': ELSE : DATA_USE PROG$ 

1227 INPUT #0, \, "NET STATION NUMBER ? "; MS: IF M$ <>’’ THEN NET NS 
1230 LET N$ = DATES: LET M$ = HS( 1 TO 4 ) 

1235 IF NS <> "1994" THEN 


1240 MERGE DEVS & ’BOOTS DATE’ 

3000 ELSE 

3010 LET Y% = HS 

3020 LET MS = DATES: LET D% = M$( 10 TO 12 ) 
3030 LET M$ = WS( 5 10 9) 

3040 END IF 


3050 IF DEVS( 1 ) = 'N’ THEN NET 2: NFS_USE MDV, N1_FLP1_, Nl_FLP2_, N1_FLP3_, N1_FLP4_: PRINT TO 5, "MDV NOW SET TO 
N1_FLP" 

3070 LRESPR DEV$ & ‘EXTENSIONS_HERMBAUD’ 

3080 CSIZE #0, 2, 1: PRINT #0, \ TO 8; " TODAY’S DATE IS: " 

3090 CSIZE #0, 3, 1: PRINT #0, \ TO 8; D3; MS; Ye 

3100 IF NOT HERMIS THEN 


3110 CSIZE #0, 0, 0: INPUT #0, ‘ARE YOU USING A PC KEYBOARD (Y) ? ’; HS 
3120 IF NOT MS == ’Y’ THEN MRUN DEVS & ‘BOOTS_NO_HERMES’ 
3130 END IF 


4000 PRT_USE SER,SER 

4020 CSIZE #0, 0, 0: CLS #0 

4022 PRINT #0, " INSTALLED programS : " 

4024 CSIZE #0, 1, 0: PRINT #0, \ " Qpac2" \ " VARIOUS SBasic EXTENSIONS" \ " FUNCTION-KEY DEFINITIONS" 

4026 PRINT #0, \\ " < alt Q > HAS QUILL" \ " < alt E > HAS THE EDITOR" \ " < alt S > HAS superBASIC" \ " < alt B > HAS 
multiBASIC" \ " < alt H > HAS HACKER " 

4027 PRINT #0, " < alt A > HAS ASSEMBLER" \ " < alt X > HAS TURBO XCHANGE " \ " < alt D > has DATAdesign" \ " < alt L > 
SPELLs a file" 

4028 PRINT #0, " < alt I > has Basic Reporter" \ " < alt t > SPELLs current task" \\ 

4035 WINDOW 256, 200, 256, 50 

4040 DO "RAM1_TASKS" 
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Basic. The reason for this is that 
where possible, I prefer the tasks 
that I install not to assume that 
associated files will be on FLP1_. I 
either use a config program or 
manually hack the program to look 
first to RAM1.. I consider this 
appropriate because I may not 
actually start using, say Text87, for 
an hour or so, and may have put a 
different disk in FLP1_ in the 
meantime, and then forget to put the 
BOOT disk in the drive. These files, 
therefore, include help-files, start-up 
defaults (as for TEXT87), and a 
Qtyp dictionary. 


I have also adapted a program by 
Ian Malcolm which cures an obscure 
incompatibility between QIMI and 
MINERVA. This program only 
pokes memory so can safely be run 


Figure 4 - Boot Date 


2020 IF DEVS( 1 ) = 'N’ THEN 
2040 


from a Multi-Basic. Thirdly, I have 
adapted a Quanta program (by 
Tony Tebby) called QDOS_ MSG. 
This program allows one to change 
the error messages to whatever one 
wishes. It uses the TRA command, 
which I do not fully understand. The 
program reserves some memory, 
and this is done from SuperBASIC 
(line 160) and passed to the Multi- 
Basic, as described below. It is also 
possible to put ALTKEY and 
HOT_KEY commands in a Multi- 
Basic. 


The check for ROM version (line 
137 and 140) is done this way 
because Simon Goodwin says there 
is a bug in JS and earlier machines 
which causes problems when using 
VER$ within IF-THEN lines, such 
as, "IF VER$=’JSL1’ THEN". 


AS = DATES( FUPDT( \ TIMES )): DELETE TIMES 


2050 
2060 
*bO) 
2070 


LET TIME = AS((" " INSTR AS( 10 TO ) + 10 
LET TIMES = AS(( ":" INSTR AS ) + 1 T0 )( 


LET NAMES = CHRS( 
& CHRS( 5 ) & "May" & CHRS( 6 ) & "Jun"& CHRS( 


Nr 


) & "Jan" & CHRS( 2 
) & "Jul" & CHRS( 8 


& CHRS( 11) & "Nov" & CHRS( 12 ) & "Dec" 


2080 
2090 
2100 
2120 
2130 
2140 
2150 
2160 
gn 

2170 


LET Y% 

LET M$ 

LET Y% 
ELSE 


2180 
2190 
2200 
2210 END IF 
2220 SDATE Y%, MS, D%, TIME, TIMES, 0 


numbers is needed to allow for code on the ROM and is accessed Trump card, the boot ran 2 seconds 


future changes. 
An extra check has had to be 


introduced to check for MINERVA 
v1.97 which includes the Multi-Basic 


QReview 


( 
C 
A 


LET D% = AS( 10 TO ( " " INSTR AS( 10 TO ) + 9 )) 
LET M$ = AS( 6 TO 8 ) 


MS INSTR NAMES ) 
ODE( NAMES( Y% - 1 )) 
$( 1705 ) 


)+4)T0) 


by "EXEC ’pipep’". Alternatively, 
Line 174 copies the Multi-Basic task 
to RAM disk. The file is used 
several times, and file access is 
quicker for a RAM disk. Using a 
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The RAM disk has a size specified 
because I thought that this might 
allocate a continuous piece of 
memory to the RAMdisk, and 
therefore, avoid memory 
fragmentation (particularly with a 
Trump card). However, I am not 
sure that this has worked as 
intended. 


Line 160 reserves the memory 
necessary for the Quanta program 
mentioned above to alter the QL 
error messages. Lines 170 to 2000 
are the main utilisers of 
MINERVAs abilities. If you have 
MINERVA, two programs are run 
from Miulti-Basics. If you are 
running on an earlier ROM, then 
these two programs are merged. 
Thus the importance of line 
numbers. Wide spacing of line 


LET TIMES = "N1_RAM1_TIME": LET TIME = FOP_NEW( TIMES ): IF TIME > 0 THEN CLOSE #TIME: LET 


) TO ( ":" INSTR AS )) 
1 TO ( "3" INSTR AS((( ":" INSTR AS ) +1) TO ) 


) & "Feb" & CHRS( 3) & "Mar" & CHRS( 4) & "Apr" 
) & "Aug" & CHRS( 9 ) & "Sep" & CHRS( 10 ) & "Oct" 


CSIZE #0, 3, 1: PRINT #0, \ TO 7; " TODAY’S DATE Is ? * 
CSIZE #0, 1, 0: PRINT #0, \\ TO 20; " IN THE FORM : 18 2 1990 ": LET TIME = 0: LET TIMES = 


INPUT #0, \ TO 27; AS: IPF AS = "" THEN LET Y% = M$: LET M$ = DATES: LET D% = MS( 10 TO 12 
): LET M$ = MS( 5 TO 9 ): GO TO 2221 

LET D¢ = AS( 1 TO ( " " INSTR AS ) - 1 ) 
LET M$ = AS(( " " INSTR AS ) + 1 TO ( " " INSTR AS( 470 )) +2) 
LET Y¢ = AS(( * " INSTR AS( 4 TO 


faster when I changed the boot 
program to use the "EXEC ’pipep” 
rather than copy the Multi-Basic 
file. 
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Multi-Basics load the programs they 
are to run in this way: 


EXEC Multi-Basic; ‘program’ & ‘>’ & 
‘data or filename’ 


The data is put in a variable called 
CMD$ and can be used or spliced as 
with any other variable in the Multi- 
Basic. 


Line 1227 is not strictly necessary 
on non-networked machines, nor 
MINERVA MKII machines. The 
MKII battery RAM allows the NET 
station number to be stored and 
allocated on boot. It is here to 
provide compatibility with the 
Sinclair ROMs 


Likewise with line 1230. MINERVA 
users might like to replace this line 
with "LET M$ = DATES()( TO 4 )" 
which will produce the same value 
in M$ 


Unfortunately, I know of no way of 
independently checking the machine 
date other than hard-wiring the 
program, as here (line 1235). or 
asking the user at boot time. You 
could check the complete date, but 
in my experience, using the year is 
sufficient. If the date is incorrect, the 
small program. called 
BOOTS_DATE, is loaded. 


This first checks to see if the 
computer is being booted across a 
network. If so, then the date is 
gained from the source machine 
(assuming the date is correct there; 
perhaps that should be checked 
for...). This can be achieved by using 
the TK2 function FOP_NEW to 
open a new file. This returns the 
error code that was returned by the 
attempt to open a new file. If the 
error code is not zero then we have 
a problem. Assuming all is OK, then 
FUPDT will discover the date the 
file was last updated, which is just 
about the correct time since we have 
just created the file. The date is 
returned as a number so we must 
use the DATES function to turn the 
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number into something more useful. 
This is an adaption of a routine that 
is in the Minerva manual. If one is 
not booting across a network, the 
user is prompted for the correct 
date. This is my most unreliable 
piece of code because it has rarely 
been tried in action (note the use of 
’"GOTO’ in line 2170). It can be 
made much more efficient if 
MINERVA’s date splicing 
enhancements are used. 


line 3050 redirects queries from the 
Microdrives to the file server’s 
devices. This allows re-use of, 
presumably, currently redundant 
device drivers (MDV) rather than 


struggling with rather long 
N1_FLPn. 


A recent change can be seen 


Figure 5 - Backup 


31190 : 
31195 : 
31200 DEFine PROCedure BACKUP( AS } 


then change your mind after you 
have. started printing a file you have 
to type in the Toolkit II command 
PRT_ABT to stop it printing out. 


The final lines (4020-4035), remind 
the user of the ALTKEY (or 
HOT_KEY) definitions one has set 
up. Lastly comes the little used 7DO’ 
command. The rational for its use 
will be explained in the next issue. 


The code that is run in Multi-Basics 
can safely be compiled. Why then 
bother with Multi-Basics when 
compiled code runs 
quicker? Compiled code is more 
difficult to change if I add software. 
Moreover, since the routine that 
takes the longest is copying files, 
compiling it would produce little 
speed improvement. 


31203 PRINT "RENAME TEST_BOOT TO BOOT ?": LET Y¥ = GET_KEY 
31205 IF NOT Y THEN COPY_O "FLP" & AS & "_TEST_BOOT" TO "FLP" & AS & "_BOOT" 


31207 SAVE_O "FLP" & AS & "_TEST_BOOT" 


31210 END DEFine BACKUP 


between lines 3100 and 3130. 
Originally I used a small program 
printed in QL World (RIP) to 
provide a keyboard beep. Last year 
I purchased Hermes. That required 
the first change to test if Hermes 
was present. The program provided 
with Hermes which tests for 
HERMES’s existence is safe to use 
on non-Hermes equipped QL’s. 
More recently, I purchased Jurgen 
Falkenburg’s PC keyboard interface. 
Unfortunately, this is designed to be 
invisible to the QL. There is, 
therefore, no way to test for its 
presence except to ask the user... 


The PRT_USE statement (line 
4000) allows one to start printing 
and then carry on with other work 
on the QL without having to wait 
for the file to complete printing. The 
only downside with this is that if you 
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As an end-piece, here is a small 
routine to allow you to back up this 
program (figure 5). If one types 
"BACKUP "no", where ‘no’ is the 
drive you the file backed up to, e.g. 
BACKUP ’1’ will save the file on 
FLP1_. Just in case you have made 
‘a horrendous mistake, the file is 
saved as "TEST BOOT’. You will 
be asked if you wish your previous 
version of "TEST BOOT’ installed 
as the current BOOT program. 


Plug: Visit your local Quanta group 
for help-ful advice and have most 
new programs demonstrated for you 
before having to shell out your 
money. 


Andrew Pratt 
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~ SCREEN COMPRESSION — _ 


From the adverts of this 
program it is designed to 
allow the conversion of 
various graphic compression 
formats and to allow the 
screens to be saved in 
compressed form. 


The package consists of four 
AS printed instruction sheets 
and a 3.5" disk. 


The program can be loaded by 
either LRUNing the boot 
program supplied or 
EXECing the program 
directly. Two versions of the 
program are supplied on disk 
one being a smaller but faster 
version that will work if you 
have the QLiberator 
extensions loaded. The 
program is fully configurable 
via the QJUMP Config 
program which is supplied. 


Once loaded you _ are 
presented with a_ screen 
showing all the options 


available. 


The program is _ fully 
multitasking. I found this was 
useful as I frequently changed 
to SuperBasic to carry out a 
DIR on the disk that I was 


transferring information to 
and trom. 
The options available are 


large. but basically fall into 
three categories:- 


i) What information you are 
reading in. 

ii) What type of information 
you want to send out. 

iii) Whether you want to view 
or view and_ save _ the 


information read in. 


The latter option is relatively 
straight forward, that is not to 
say the others are complex 
just that there are many 
combinations. 


Eleven compression formats 
are catered for :- Eye-Q, DJC, 
Painter, uncompressed, 
A.Quigley ( QL World ), 
R.Dwight ( Quanta ), CGA, 
PCX, QOplus, Moerel and 


MODES = NODE 2/87 :' 
aC PRINTER 
GRAPHIC tK PCX 


S~ Gest, crive + FLP2_ 


~ Extension 
? = Screen wd 
§ = Conpression 


graphics toolkits. Some of 
these will be very familiar and 
some very obscure. 


To use the program you move 
up and down the list of 
commands using the cursor 
keys and toggle between the 
possible options. The overall 
design of the program is one 
of ease of use. 


When testing the program I 
initially came across some 
problems but after reading the 
instructions again these 
disappeared. 


I found that the program was 
simple to use but wondered 
about its appeal to QLers. 


The program does what it sets 
out to do, but to how many 
people actually want a 
program to convert between 
formats I am not sure. 


The final twelve lines of the 


manual mention Dilwyn’s 
routines SQUASH% and 
EXPAND. More 


importantly, included on the 
disk are BASIC programs 
showing how to use_ these 
functions. These programs 
are clearly written and are 
explained very well. The 
programming style is clear 
and I found that I spent longer 
playing with these programs 
than with the actual Screen 
Compression program. 


The fact that the program is 
easy to use makes it a good 
purchase. the additional basic 
programs supplied make it 
even better. So much better 
that as I will have to send my 
review copy back I bought the 
program from Dilwyn with a 
record two days delivery from 
when I sent the cheque. 


The cost is just £10.00 which I 
feel is more than reasonable. 


John Southern 


Screen Compression costs 
£10 (UK), £11 (Overseas) 
and can be obtained from 
Dilwyn Jones Computing 
(0248) 354023, 41 Bro 


Emrys, Tal-Y-Bont, 
Bangor, Gwynedd, LL57 
SUE 
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im stillen Winkel 12 * 47169 Duisburg * Germany 
@ and Fax: 0203=501274 + Mailbox: 0203-591706 . 


SMSQ will work on ony system which has o minimum of 1MB RAM and a foster 
processor thon the QL: all ATARI ST/STE/TT (with or without QL emulator), Gold- 
Cord and SuperGoldCard and QXL SMSQ is not o modified QL-ROM-bosed sys- 
tem, it is completely rewritten. This resuits in better performance ond very many 
new features. SMSQ can be divided into three main ports: the Operating System, 
SBASIC ond DV3. All three parts give advantages in all systems, and they will have 
oO unique interface (ogain, after the way divided a bit between the Emulator with 
many features ond ather systems with less features). 

The behavior of the operating system con be defined: if you want it to behave like 
QDOS {bad reaction under heavy locd), then programs run foster. It can be set to 
de as fost os QDOS, but with o better reaction under lood, For the ATARIs, 5 levels 
of memory protection can be defined. The operoting system calls are, in general 
and on ali systems, faster thon QDOS. You can independently select the keyboord 
you're using, various translation tables (English, French, German, IBM and GEM), 
end the longuoge for messages! The input line editing is extended to give you bet- 
ter editing control, 

The SBASIC; You can now start cs mony interpreted BAS!Cs cs you wont, oll runn- 
ing indepencently. And you con odd “private” extensions to these SSASICs, which 
go away when the job goes awoy. _BAS programs con now be EXecute, so you 
con't have to compile (filters) onymare. BASICs con be positioned everywhere on 
tne screen (by call}. SBASIC runs interpreted at cbout the same speed as compiled 
(QLiberctec) BASIC, i.e. MUCH fester than SuperBASIC used ta run. And, of 
course, o large number of improvements have been made, to give you an ideo: 
you con Girectly enter nexcdecimol ond binary numbers / fost integer FOR and 
SELect / improved error messages / BPUT, BGET now allow string to be param- 
eters / END FOR, END REPeat, REPeat, NEXT etc. don’t need co nome anymore / 
LOAD, MERGE olso accepts QSAVEd files / SAVE does not need a filename, it 
saves the file under the same name it has been loaded / extended PEEK and POKE, 
PEEKS, POKES / LBYTES, SBYTES etc. accept chonne! numbers instead of filename 
‘improved slicing / machine-detection functions exist / ... ond more! Default chon- 
ne! commands (ED defaults to #2, DIR to £1, BPUT to #3) now use chonnel £0 
insteca if they find that their default chonnel is not open- ond if £0 is not open, it is 
opened implicitly! 

Device Driver Level 3 - gives you flexible formots. You con access co DOS or TOS- 
Disk exoctly like you access ce QDOS disk, the system detects the format automati- 
cally. If you insert a DOS disk and type DIR fip1_, then you get a directory of it. You 
con use oli tne normal file commands in every program (not special extensions like 
ATR or ATARI-DOS) to occess files to copy, delete, locd etc. This allaws yau to boot 
from one disk, even if it is o TOS/DOS disk! 


proudly presents: SMSQ - the new QDOS compatible Operating System 


The WIN feotures are greotiy enhanced on the ATARI version: you can now access 
ANY QDOS or TOS partition on cny drive, even Extended Gem ond Big Gem. You 
can now have more than one QDOS partition on ane drive, You defined WIN2_ to 
be TOS-Partition C or Dor..., win3_ to be partition 7 etc., all this is VERY useful to 
transfer documents, graphics etc. between various systems. Ang, you can soft- 
wore-write-protect one or more horddisk partitions. Full harddisk contro! vio 
WIN_Control Thing! 

In additian, HD (1.4MB) disks are now supported on the ATARIs too! Full floppy 
disk control vio FLP_Controi Thing! 

Finolly, the various bits which don’t belong into ony of the three categories above: 
The seriol and poralle! port drivers of all systems hove been put to the high stenc- 
ords of the ATARI drivers: more porameters, you can define in the device name 
whether this channel uses TRA or not (instead of taggling the global TRA all the 
time}, dynomic buffers hove been added. Full contro! of the part parameters witn 
the SER_PAR_PRT Thing! 

Other virtual drivers hove been added or improved: nomed pipes {first in, first out, 
of course), History (lost in, first out, new!! Even shared Histories ore ollowr 
DEV, the virtual directory device which allows search chains to be built. 
The standard ATARI version supports the Qi-Emuictors/QVME, but it is possibile 
to get o version which supports the monochrome 640x400 display too, which run 
on ATARIs without emulotars (and the Stacy!!!) in addition. The resolution con now 
be changed ot run time on the Extended Mode emulctor (you could always co it 
on the QVME). 

It has taken a bit longer thon estimoted, but for more fecilities than originally 
planed were implemented. Latest news: you cen execute SBASIC programs even 
out of the QPAC2 Files menu. You also get an SBASIC/QD F10 Thing interface 
inuilt for free, so thot you can use QO for writing, editing and storting 
(uncompiled) SBASIC programs! 

As you can see, you get o system you were always dreaming off. We decided to 
offer it in steps, with the moin part (os described above) being ready now! “ais 
means you con now benefit from whot exist now - ot the same price in steps that 
the final version would cost in totol. Later on, a new Screen driver will come which 
will ollow thot printing will always continue, even to a window which is completely 
or partially overiopped by other windows. Visible areas of overlapped windows 
will be updoted to the screen!!! Then we will hove (everyone's wanting this for 
years) "background" floppy/harddisk operation, i.e. when files are read or written, 
the whole machine does nat stop anymore completely. The third improvement 
stoge will we a pointerintegrated SBASIC environment with Singlestep/trace 
facilites and more. 


Ong 


Feature ATARI ST(E)/TT (Super)GoldCard QXL 

oe New Operating System DM 199,- NEW already ex. 
= Multiple, fast BASICs Gives NEW already ex, 
= Flexible Level 3 Drivers Level C, DorE NEW already ex. 
a : . lready) else 
< HD Disk-drive support (STE/ y. already ex, * already ex. 
x pemteyeyni) DM 249,- y : 
a) TT Fast RAM support impossible impossible 
Ss Monochrome Screen-criver + DM 50,- impossible impossible 
4 2 New Screen-driver NEW NEW DM 2493,- 
me = = = 
Soe “background” Disk/Harddisk impossible NEW + DM 50,- 
c= - 
<3 BASIC-Development-Environment NEW + DM 50,- 

Total price (when all is available) with rebate, without DRG 349,— DM 299,~ DM 343,- 
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|More news from Jochen Merz Software are coming: WINED, a pointer-driven editor for all sorts of media (Harddisk, Floppy disk) - and with its 
mony features it offers far more than a plain sector editor! MENUCONFIG Level 2 - are you bored of having to re-configure all the new files you get 
every time you update? Select every item you want to change? CONFIG Level2 does it automatically for you. It remembers your last configuratic'+ 
and updates more recent version automatically! More news in the latest Jochen Merz Software Catalogue which you can get for free! 


TERMS OF PAYMENT 


Postage and package (Europe) DM 14,- (if total value of goods is up to DM 50,- then only DM | ; 
93,-). (Overseas) between DM 14,- (1 item) and DM 35,- (maximum). All prices incl. 15% V.A.T. \—svaSeano” 
(can be deducted for orders from non-EEC-countries). E&OE. Cheques in DM, £’s, Eurocheques 

( 


and Credit Cards accepted. 


special bonus (we know that many users own more than one system}, we offer a full package which contains versions for all three systems for only 
more. This also applies to the upgrades, e.g. DM 66,66 instead of DM 56,-, which, we think is very fair (it just covers extra disks and manuals}., 


Rie 


